# Crimes Financeiros - FinCEN

> Consulta listas restritivas de crimes financeiros para identificar empresas e indivíduos envolvidos em lavagem de dinheiro, financiamento ao terrorismo e atividades ilícitas.

- **Consulta:** `fincen-crimes`
- **Categoria:** Internacional
- **Preço:** R$ 0,43 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/fincen-crimes`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/internacional/fincen-crimes

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Consulta registros de entidades envolvidas em atividades ilícitas monitoradas pela Financial Crimes Enforcement Network (FINCEN), órgão responsável pela prevenção de lavagem de dinheiro, financiamento ao terrorismo e outras práticas criminosas no sistema financeiro. Este endpoint realiza triagem de pessoas e empresas contra listas restritivas, essencial para compliance regulatório e gestão de risco em processos de onboarding, análise de crédito e detecção de envolvimento de personalidades politicamente expostas (PEP).
>
> A consulta retorna dados históricos e registros cadastrais relacionados a entidades sob escrutínio internacional, permitindo que organizações mitiguem riscos regulatórios e reputacionais com cobertura abrangente de sanções e restrições.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/fincen-crimes?nome=SEU_NOME"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/fincen-crimes",
    params={"nome": "SEU_NOME"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/fincen-crimes");

url.search = new URLSearchParams({
  "nome": "SEU_NOME"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `nome` | texto | sim | Nome completo para busca | formato: Nome completo |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta é organizada em duas seções:
>
> **Metadados da Consulta**
> - Identificadores únicos da requisição (`consultaUid`)
> - Informações do usuário e IP da origem
> - Status geral da operação (`resultado`)
> - Timestamp de execução e tempo de processamento
>
> **Dados Encontrados**
> Quando registros são localizados, retorna um conjunto de empresas/entidades com os seguintes campos:
>
> - **Identificação**: Razão social, nome fantasia, número de registro nacional
> - **Autorização**: Data de assinatura autorizada, data de recebimento do registro
> - **Estrutura**: Quantidade de filiais, número de identificação para serviços monetários (MSB)
> - **Localização**: Endereço completo (logradouro, cidade, estado, CEP, país)
> - **Serviços**: Tipo de serviço monetário prestado, atividades registradas
> - **Jurisdição**: Estados e territórios onde a entidade opera
>
> O campo `resultadosEncontrados` indica a quantidade total de registros que correspondem à busca.

### Exemplo de resposta

```json
{
  "consta": "boolean",
  "mensagem": "string",
  "parametros": {
    "nome": "string"
  }
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "retorno": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "empresas": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "numeroMSB": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Número de identificação MSB."
              },
              "localizacao": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "pais": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "País."
                  },
                  "cidade": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Cidade."
                  },
                  "estado": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Estado."
                  },
                  "endereco": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Endereço completo."
                  },
                  "codigoPostal": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Código postal."
                  }
                },
                "description": "Dados de localização da empresa."
              },
              "razaoSocial": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Razão social da empresa."
              },
              "nomeFantasia": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Nome fantasia da empresa."
              },
              "dataRecebimento": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de recebimento do registro."
              },
              "servicoMonetario": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "numero": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Número de identificação do serviço."
                  },
                  "estados": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "description": "Lista de estados onde o serviço opera."
                  },
                  "atividades": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "description": "Lista de atividades registradas."
                  },
                  "estadosTerritorios": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "description": "Lista de estados e territórios onde o serviço opera."
                  }
                },
                "description": "Informações sobre serviços monetários."
              },
              "quantidadeFiliais": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Número de filiais da empresa."
              },
              "dataAssinaturaAutorizada": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de autorização da assinatura."
              }
            }
          },
          "description": "Lista de empresas encontradas."
        },
        "observacoes": {
          "type": [
            "string",
            "null"
          ],
          "description": "Observações adicionais sobre os resultados."
        },
        "nomeConsultado": {
          "type": [
            "string",
            "null"
          ],
          "description": "Nome consultado na busca."
        },
        "resultadosEncontrados": {
          "type": [
            "number",
            "null"
          ],
          "description": "Quantidade de resultados encontrados."
        }
      },
      "description": "Dados retornados pela consulta."
    },
    "metaDados": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "ip": {
          "type": [
            "string",
            "null"
          ],
          "description": "Endereço IP da requisição."
        },
        "data": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data e hora da execução da consulta."
        },
        "chave": {
          "type": [
            "string",
            "null"
          ],
          "description": "Chave de identificação da consulta."
        },
        "usuario": {
          "type": [
            "string",
            "null"
          ],
          "description": "Usuário que realizou a consulta."
        },
        "mensagem": {
          "type": [
            "string",
            "null"
          ],
          "description": "Mensagem de resposta da consulta."
        },
        "apiVersao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Versão da API utilizada."
        },
        "resultado": {
          "type": [
            "string",
            "null"
          ],
          "description": "Status do resultado da consulta."
        },
        "assincrono": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se a consulta foi assíncrona."
        },
        "consultaUid": {
          "type": [
            "string",
            "null"
          ],
          "description": "Identificador único da consulta."
        },
        "resultadoId": {
          "type": [
            "number",
            "null"
          ],
          "description": "Identificador do resultado."
        },
        "consultaNome": {
          "type": [
            "string",
            "null"
          ],
          "description": "Nome da consulta realizada."
        },
        "enviarCallback": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se será enviado callback."
        },
        "urlComprovante": {
          "type": [
            "string",
            "null"
          ],
          "description": "URL do comprovante gerado."
        },
        "tempoExecucaoMs": {
          "type": [
            "number",
            "null"
          ],
          "description": "Tempo de execução em milissegundos."
        },
        "gerarComprovante": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se será gerado comprovante."
        }
      },
      "description": "Metadados da consulta."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Este endpoint gera comprovantes em formato PDF, útil para documentação de compliance e auditoria interna.
> - A cobertura inclui bases de dados internacionais, possibilitando identificar envolvimento de entidades em contextos transnacionais.
> - Recomenda-se integrar esta consulta em fluxos de validação de novos clientes, análise de risco de transações de alto valor e verificações periódicas de relacionamentos já estabelecidos.
> - A resposta pode conter múltiplos registros para um mesmo nome, refletindo variações de denominação social ou distintos períodos de operação.
> - Em caso de nenhum resultado, a resposta retornará `resultadosEncontrados` igual a zero com observações adicionais.

---

Página em HTML: https://fontedata.com/docs/internacional/fincen-crimes
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp