# Quod Detecta Laranja

Score probabilístico de propensão a fraude, focado em prevenir a abertura de relacionamento com "laranjas" (pessoas que emprestam seus dados para lavagem de dinheiro e estelionato).

- **Identificador:** `pessoas/quod-detecta-laranja`
- **Categoria:** Crédito, renda e birô
- **Audiência:** PF
- **Endpoint:** `POST /api/v1/{tenant}/pessoas/quod-detecta-laranja`
- **Preço de tabela:** R$ 2,620 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/pessoas/quod-detecta-laranja

## Quando usar

Descrição

O Quod Detecta Laranja retorna a probabilidade de um onboarding ou transação ser fraude. O score varia de 300 a 1000, em que 300 é a maior e 1000 a menor probabilidade de fraude. Para a consulta basta o CPF.

Dados opcionais

CEP, e-mail, celular com DDD, UF e valor da transação podem ser informados para refinar o cálculo.

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `document` | sim | CPF da pessoa, com ou sem máscara. |
| `zip_code` | não | CEP (8 dígitos) |
| `email` | não | E-mail |
| `phone` | não | Celular com DDD |
| `state` | não | UF |
| `transaction_value` | não | Valor da transação |

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `DetectOrangeAccountResponseEx.Response.Header.Status` | número |
| `DetectOrangeAccountResponseEx.Response.Header.Message` | texto |
| `DetectOrangeAccountResponseEx.Response.Header.QueryId` | texto |
| `DetectOrangeAccountResponseEx.Response.Header.TransactionId` | texto |
| `DetectOrangeAccountResponseEx.Response.Records.DetectOrangeAccountOutput[].FraudScoreOrange` | texto |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Quod Detecta Laranja",
  "query_slug": "quod-detecta-laranja",
  "data": {
    "DetectOrangeAccountResponseEx": {
      "Response": {
        "Header": {
          "Status": 0,
          "Message": "texto",
          "QueryId": "texto",
          "TransactionId": "texto",
          "Exceptions": {
            "Item": [

            ]
          }
        },
        "Records": {
          "DetectOrangeAccountOutput": [
            {
              "FraudScoreOrange": "texto"
            }
          ]
        }
      }
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "2.620"
}
```