> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/suspected-fraud-query.md).

# Consulta de fraude suspeita

{% hint style="info" %}
**Requisitos de autenticação:**

* Os endpoints regulares usam `OAuth2` para autenticação com a URL base: `https://api.us.prd.caf.io`
* Para maior segurança, alguns endpoints também podem aceitar `mTLS` para autenticação com a URL base: `https://mtls.us.prd.caf.io`
* Para saber como implementar `mTLS`, acesse [Usando mTLS](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/authentication/using-mtls.md)
  {% endhint %}

A consulta de suspeitas de fraude recupera as suspeitas de fraude por meio de uma pesquisa condicional.

{% openapi src="/files/28338081d0fcc9d493cdf67dcc6283c929f2d75b" path="/query" method="post" %}
[fraud.yaml](https://262277803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbVxCOSyBojfSIE5fcpfH%2Fuploads%2Fgit-blob-d3ab2969dfa76d80af01feb928533625973ac66d%2Ffraud.yaml?alt=media)
{% endopenapi %}

{% hint style="warning" %}
**Propriedades obsoletas:** `queryMode`, `startDate` e `endDate` ainda são aceitas para manter a compatibilidade do payload da solicitação, mas não têm mais nenhum efeito sobre a consulta.
{% endhint %}

## Opções

Conforme demonstrado no exemplo de solicitação, você pode definir as propriedades acima para pesquisar/consultar as suspeitas de fraude:

* O objeto `identifier` é usado para consultar ocorrências de suspeita de fraude e é composto por `data` (uma string que representa o número do documento) e por `type` (deve ser `CPF` ou `CNPJ`). É uma propriedade **obrigatória** ;
* A propriedade `queryMode` está **obsoleta**. Ela ainda é aceita no payload, mas não tem efeito sobre a consulta;
* As propriedades `startDate` e `endDate` estão **obsoletas**. Elas ainda são aceitas no payload, mas não têm efeito sobre a consulta;
* A propriedade `page` deve ser usada apenas em consultas com respostas paginadas, devido ao grande volume de dados. É um campo inteiro opcional. Se não for especificada, uma consulta padrão será executada; se for especificada, a página solicitada será recuperada.

{% hint style="info" %}
As ocorrências retornadas pela consulta não incluem mais o `token`. Para recuperar os tokens das suspeitas de fraude criadas pela sua organização, use a [Lista de suspeitas de fraude](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/suspected-fraud-list.md).
{% endhint %}

## Solicitações equivalentes simultâneas

Enquanto uma consulta para o mesmo `identifier` da sua organização ainda estiver sendo processada, uma solicitação equivalente receberá `425 Too Early`. Tente novamente após o intervalo indicado pelo cabeçalho `Retry-After` .

## Respostas paginadas

As respostas paginadas são usadas para lidar com o grande volume de dados agregados retornados. Cada página contém até **5.000 entradas** e é ordenado por data de ocorrência, com as entradas mais recentes aparecendo primeiro.

As páginas são válidas por **1 hora**. Após esse período, qualquer tentativa de acessar essas páginas resultará em um erro `410 Gone` erro. Da mesma forma, tentar recuperar páginas para consultas não paginadas também resultará em um erro.

A paginação usa indexação baseada em zero — lembre-se disso ao solicitar as páginas seguintes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/suspected-fraud-query.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
