--- title: "Consulta PEP" description: "API Consulta PEP - Proteja seu negócio com verificação política automática A API Consulta PEP permite identificar rapidamente se um CPF pertence a uma Pessoa Exposta Politicamente (PEP), garantindo mais segurança e conformidade nas suas operações. Com integração rápida via endpoint pessoa-exposta-politicamente, você incorpora em minutos ao seu sistema uma checagem confiável para cadastros, análise de crédito, onboarding digital e prevenção à lavagem de dinheiro. A API retorna informações estruturadas sobre o status de PEP, facilitando regras automáticas de aprovação, alçadas diferenciadas e trilhas de compliance. Assim, seu negócio ganha agilidade, reduz riscos regulatórios e melhora a qualidade das decisões sem fricção na experiência do usuário." lang: pt-BR canonical: https://doc.apibrasil.io/apis/creditos/9ad22565-54dc-4c77-b211-f1ecbd233c82 markdown: https://doc.apibrasil.io/apis/creditos/9ad22565-54dc-4c77-b211-f1ecbd233c82.md source: apibrasil-documentation --- # Consulta PEP > API Consulta PEP - Proteja seu negócio com verificação política automática > A API Consulta PEP permite identificar rapidamente se um CPF pertence a uma Pessoa Exposta Politicamente (PEP), garantindo mais segurança e conformidade nas suas operações. Com integração rápida via endpoint pessoa-exposta-politicamente, você incorpora em minutos ao seu sistema uma checagem confiável para cadastros, análise de crédito, onboarding digital e prevenção à lavagem de dinheiro. A API retorna informações estruturadas sobre o status de PEP, facilitando regras automáticas de aprovação, alçadas diferenciadas e trilhas de compliance. Assim, seu negócio ganha agilidade, reduz riscos regulatórios e melhora a qualidade das decisões sem fricção na experiência do usuário. - **Categoria:** Análise Antifraude - **Cobrança:** por consulta, só com o Bearer Token - **Preço:** R$ 0,66 por consulta - **Limite:** 990.000 por mês - **Cadastro:** exige CNPJ - **Versão:** v2 - **Publicada por:** APIBrasil - **Especificação OpenAPI:** https://doc.apibrasil.io/apis/creditos/9ad22565-54dc-4c77-b211-f1ecbd233c82/openapi.json ## Como chamar **Endereço base:** `https://gateway.apibrasil.io/api/v2` Autenticação: cabeçalho `Authorization: Bearer `. Nada além disso. Com `homolog: true` no corpo, o gateway responde de uma base fixa, com a forma real da resposta, e não cobra. O CPF 00000000000 é dessa base e não é de ninguém: use-o nos testes, nunca em produção. ## Endpoints (1 endpoint) ### 1. POST /consulta/cpf/credits API Consulta PEP - Segurança e Conformidade em Segundos A API Consulta PEP permite verificar rapidamente se um CPF pertence a uma Pessoa Exposta Politicamente, garantindo mais segurança, conformidade regulatória e redução de riscos nas suas análises de cadastro e crédito. Com método POST no endpoint pessoa-exposta-politicamente (consulta/cpf/credits), a integração é simples e rápida em qualquer ambiente, do seu CRM ao sistema de onboarding digital. Em poucos milissegundos, sua aplicação recebe um retorno estruturado, pronto para ser consumido por motores de decisão, fluxos de compliance, prevenção à lavagem de dinheiro e monitoramento contínuo de clientes. Isso gera ganho direto de produtividade, padroniza critérios de aprovação e fortalece a governança da sua operação, sem fricção para o usuário final. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/cpf/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "cpf": "00000000000", "tipo": "pessoa-exposta-politicamente", "homolog": true } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/cpf/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"cpf":"00000000000","tipo":"pessoa-exposta-politicamente","homolog":true}' ``` Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação. **Resposta de exemplo, do catálogo** ```json { "user": { "first_name": "[omitido]", "email": "[omitido]", "cellphone": "[omitido]", "notification": "yes" }, "balance": "108,300", "balance_before": "108,300", "tax": "0,000", "status_code": 200, "error": false, "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.", "valor_consulta": 0, "api_limit_for": "homolog", "homolog": true, "data": { "cpf": "000.000.000-00", "dataConsulta": "16/04/2026 10:57:56", "funcao": null, "nome": "USUARIO HOMOLOGACAO TESTE", "orgao": null, "parentescosPEP": [], "pep": false, "relacionadoComPEP": null, "status": "Usuario de homologacao nao identificado como PEP ou relacionado." } } ``` Nos exemplos de resposta, os campos da conta que gerou o exemplo (`user.first_name`, `user.email`, `user.cellphone`) saem como `[omitido]`. O resto é o que o catálogo publica. ## Armadilhas: o que uma integração erra sem avisar Apuradas nas respostas que o próprio catálogo publica. Em todas elas o código funciona no caminho feliz e falha em silêncio no resto: 1. **O erro chega no CORPO, com HTTP 200.** A resposta traz um campo `error` booleano e uma `message`. Checar só `response.ok` ou o status HTTP deixa passar falha como sucesso. Confira SEMPRE `error === false` antes de ler `data`. 2. **`balance`, `tax` e `extra_charges.total` são STRING em formato brasileiro — e o formato varia entre APIs.** Valores observados no catálogo: `"154,380"`, `"497,84"`, `"0,000"` e `"0.19"`. Vírgula em umas, ponto em outra; três casas decimais em umas, duas em outra. Em JavaScript, `parseFloat("154,380")` devolve `154` e perde os centavos sem erro nenhum, e `Number("154,380")` devolve `NaN`. Escreva um conversor que trate os dois separadores, e nunca use esses campos numa decisão financeira sem convertê-los. 3. **Cada chamada custa dinheiro.** Retry cego multiplica a conta. Nunca repita automaticamente um 4xx: parâmetro errado repetido continua errado e continua cobrando. Repita só tempo esgotado e 5xx, com recuo exponencial e um teto pequeno de tentativas. 4. **HTTP 402 é saldo insuficiente, e repetir não resolve.** É o único status que exige ação humana — recarregar. Trate-o como erro terminal, com mensagem própria, e não o jogue no mesmo balde dos 4xx genéricos. 5. **`extra_charges` cobra à parte do preço da consulta.** Quando o corpo pede serviços adicionais, a resposta traz cada um com o preço e um `total` que NÃO está incluso no valor base. Se você mostra custo a quem usa, some os dois. ## Ver também - Especificação OpenAPI: https://doc.apibrasil.io/apis/creditos/9ad22565-54dc-4c77-b211-f1ecbd233c82/openapi.json - Catálogo de APIs: [Catálogo de APIs](https://doc.apibrasil.io/apis.md) - SDKs oficiais: [SDKs oficiais](https://doc.apibrasil.io/sdks.md) - Índice da documentação: https://doc.apibrasil.io/llms.txt - Versão HTML desta página: https://doc.apibrasil.io/apis/creditos/9ad22565-54dc-4c77-b211-f1ecbd233c82