> 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/connect/transactions/background-check/kyc/risk.md). # Risco ## Antecedentes criminais - Polícia Federal (PF3) Emissão de certidão de antecedentes criminais junto à Polícia Federal. **Seção:** `pfBackgroundCheckFederalPolice` **Parâmetro obrigatório:** `cpf, nome, nomeDaMãe, dataDeNascimento` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ---------------------- | ------ | ------------------------------------------------ | | código de status | String | Consultar status | | dados | Objeto | Dados de retorno | | data.idNumber | String | CPF da pessoa | | data.status | String | Status da certidão (encontrada / não encontrada) | | data.certificateNumber | String | Número do certificado | | data.certificateText | String | Descrição da certidão (conteúdo) | | data.emissionDate | String | Data de emissão da certidão | | data.validity | String | Validade da certidão | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso", "idNumber": "0XX52XX90XX", "certificateText": "A Polícia Federal CERTIFICA, após pesquisa no Sistema Nacional de Informações Criminais - SINIC, que até a presente data, NÃO CONSTA decisão judicial condenatória com trânsito em julgado* em nome de JOHN DOE, nascido(a) aos 08/05/1999, CPF XXX.XXX.390-XX.", "status": "NADA CONSTA", "certificateNumber": "141XXXXX2022", "emissionDate": "07:48 de 22/12/2022", "validity": "90 DIAS" } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | -------------------------------------- | ---------------------------------------------------------------------------------------------------- | | has\_no\_criminal\_background\_federal | A regra será inválida se o CPF possuir antecedentes criminais na Polícia Federal. | | has\_no\_inconsistent\_data | A regra ficará inválida se houver inconsistência nos dados enviados para consulta à Polícia Federal. | | has\_no\_criminal\_background | Verifica se o CPF possui antecedentes criminais. | | {% endtab %} | | | {% endtabs %} | | ## Mandado de Restrição de Liberdade do CNJ (PF90) Retorna informações sobre a existência de mandados (prisão, internação) junto ao Conselho Nacional de Justiça (CNJ). **Seção:** `pfArrestWarrant` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ---------------------------------- | ------ | ------------------------------------------------------------------------ | | código de status | String | Consultar status | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.status | String | Status relacionado à existência ou não de mandados (existe / não existe) | | data.warrants | Array | Lista de mandados | | data.warrants\[x].warrantNumber | String | Número do mandado | | data.warrants\[x].name | String | Nome | | data.warrants\[x].status | String | Situação | | data.warrants\[x].date | String | Date | | data.warrants\[x].issuingAuthority | String | Órgão emissor | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso - Não foram encontrados mandados de prisão ou de internação pendentes de cumprimento para: NÚMERO DO DOCUMENTO DE IDENTIFICAÇÃO: XXX52XX90XX. Pesquisa realizada em 22/12/2022 às 07h48", "status": "NADA CONSTA", "warrants": [] } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | -------------------- | ------------------------------------------------------------------------------ | | has\_arrest\_warrant | Verifica a existência de mandados junto ao Conselho Nacional de Justiça (CNJ). | | {% endtab %} | | | {% endtabs %} | | ## Processos judiciais (PF48) Retorna informações detalhadas sobre processos judiciais envolvendo pessoas físicas ou jurídicas. A fonte de dados pode incluir informações como: detalhes do caso, partes envolvidas, detalhes da acusação e histórico processual. **Seção:** `pfProcessesAlt` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | -------------------------------------------------- | ---------------- | ---------------------------------- | | código de status | String | Consultar status | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.total | Number | Número total de processos | | data.results | Array | Lista de processos retornada | | data.results\[x].id | String | Identificador da consulta | | data.results\[x].criminalCategory | String | Categoria do processo | | data.results\[x].lawsuitClass | String | Classe | | data.results\[x].distributionDate | String | Data de distribuição | | data.results\[x].statusDate | String | Data do status | | data.results\[x].lawsuitDegree | String | Grau do processo | | data.results\[x].physicalLocation | String | Localização física | | data.results\[x].oldLawsuitNumber | String | Número antigo do processo | | data.results\[x].judgingBody | String | Juízo de origem | | data.results\[x].lawsuitId | String | Número do processo | | data.results\[x].isDigitalLawsuit | Boolean | Se o processo é digital | | data.results\[x].lawBranch | String | Área do Direito | | data.results\[x].segment | String | Segmento | | data.results\[x].isJusticeSecret | Boolean | Se é segredo de justiça | | data.results\[x].complementaryStatus | String | Status complementar | | data.results\[x].observationStatus | String | Status da observação | | data.results\[x].court | String | Tribunal | | data.results\[x].state | String | ESTADO | | data.results\[x].sourceUnit | String | Unidade de origem | | data.results\[x].lawsuitUrl | String | URL do processo | | data.results\[x].lawsuitValue | Objeto | Valor do processo retornado | | data.results\[x].lawsuitValue.currency | String | Moeda (R$, U$, etc) | | data.results\[x].lawsuitValue.value | Number | Valor | | data.results\[x].subjects | Array de strings | Lista de assuntos | | data.results\[x].moves | Array | Lista de movimentações do processo | | data.results\[x].moves\[x].date | String | Data da movimentação | | data.results\[x].moves\[x].description | String | Descrição da movimentação | | data.results\[x].actives | Array | Lista de ativos | | data.results\[x].actives\[x].cnpj | String | CNPJ | | data.results\[x].actives\[x].cpf | String | CPF | | data.results\[x].actives\[x].name | String | Nome | | data.results\[x].actives\[x].type | String | Tipo | | data.results\[x].actives\[x].lawyers | Array | Lista de advogados | | data.results\[x].actives\[x].lawyers\[x].oab | String | Número da OAB | | data.results\[x].actives\[x].lawyers\[x].name | String | Nome | | data.results\[x].actives\[x].lawyers\[x].cpf | String | CPF | | data.results\[x].passives | Array | Lista de passivos | | data.results\[x].passives\[x].cnpj | String | CNPJ | | data.results\[x].passives\[x].cpf | String | CPF | | data.results\[x].passives\[x].name | String | Nome | | data.results\[x].passives\[x].type | String | Tipo | | data.results\[x].passives\[x].lawyers | Array | Lista de advogados | | data.results\[x].passives\[x].lawyers\[x].oab | String | Número da OAB | | data.results\[x].passives\[x].lawyers\[x].name | String | Nome | | data.results\[x].passives\[x].lawyers\[x].cpf | String | CPF | | data.results\[x].otherParties | Array | Lista de outras partes | | data.results\[x].otherParties\[x].cnpj | String | CNPJ | | data.results\[x].otherParties\[x].cpf | String | CPF | | data.results\[x].otherParties\[x].name | String | Nome | | data.results\[x].otherParties\[x].type | String | Tipo | | data.results\[x].otherParties\[x].lawyers | Array | Lista de advogados | | data.results\[x].otherParties\[x].lawyers\[x].oab | String | Número da OAB | | data.results\[x].otherParties\[x].lawyers\[x].name | String | Nome | | data.results\[x].otherParties\[x].lawyers\[x].cpf | String | CPF | | data.results\[x].authorType | String | Tipo do autor | | data.results\[x].authorParty | String | Parte autora | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso", "total": 7, "results": [ { "id": "XXXXXXXXfdda79638XXXXX", "criminalCategory": "XXXXXXXXXXXXXXXXXXXXXXXXXX", "lawsuitClass": "AÇÃO PENAL PROCEDIMENTO ORDINÁRIO", "distributionDate": "2017-11-24", "statusDate": "", "lawsuitDegree": "1", "physicalLocation": "", "oldLawsuitNumber": "", "judgingBody": "VARA ÚNICA", "lawsuitId": "XXXXXX", "isDigitalLawsuit": false, "lawBranch": "CÍVEL / ADMINISTRATIVO", "segment": "JUSTIÇA ESTADUAL", "isJusticeSecret": false, "complementaryStatus": "EM ANDAMENTO", "observationStatus": "ATIVO", "court": "TJ PA", "state": "PA", "sourceUnit": "XXXXX", "subjects": ["XXXXX"], "moves": [ { "date": "2018-06-19", "description": "NOTIFICAÇÃO DE NÃO CUMPRIMENTO DE ALVARÁ DE SOLTURA" }, { "date": "2018-05-25", "description": "MANDADO DE INTIMAÇÃO" }, { "date": "2018-05-25", "description": "ALVARÁ DE SOLTURA" }, { "date": "2018-05-23", "description": "A SECRETARIA DE ORIGEM" }, { "date": "2018-05-23", "description": "DECISÃO" } ], "actives": [ { "cnpj": "XXXXXX", "name": "MINISTÉRIO PÚBLICO ESTADUAL", "type": "PROMOTOR(A)" }, { "cpf": "XXX.XXX.XXX-XX", "name": "XXXXXX", "type": "VÍTIMA" } ], "passives": [ { "cpf": "XXX.XXX.XXX-XX", "name": "XXXXXX", "type": "RÉU" } ], "otherParties": [ { "cpf": "XXX.XXX.XXX-XX", "name": "XXXXXX", "type": "AGRAVANTE" } ], "authorType": "RÉU", "authorParty": "PASSIVO" } ] } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ------------------------------------------------ | ---------------------------------------------------------------------- | | has\_no\_processes | Verifica se o CPF/CNPJ está vinculado a processos. | | has\_no\_processes\_active\_party | Verifica se o CPF está vinculado a processos como parte ativa. | | has\_no\_processes\_passive\_party | Verifica se o CPF está vinculado a processos como parte passiva. | | has\_no\_processes\_other\_party | Verifica se o CPF está vinculado a processos como outras partes. | | has\_no\_defendant\_processes | Verifica se o CPF/CNPJ está vinculado a processos como réu. | | has\_no\_criminal\_processes | Verifica se o CPF/CNPJ está vinculado a processos criminais. | | has\_author\_type\_null\_in\_criminal\_processes | Verifica se há um campo 'authorType' vazio em algum processo criminal. | | {% endtab %} | | | {% endtabs %} | | ## Processos com palavras-chave (PF49) Retorna informações sobre os processos que a pessoa possui, de qualquer tipo (criminal, cível, trabalhista, ...). **Seção:** `pfProcessesWithKeywords` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | -------------------------------------------------- | ---------------- | ----------------------------------------- | | código de status | String | Consultar status | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.total | Number | Número total de processos | | data.foundWords | Array | Palavras-chave encontradas | | data.results | Array | Lista de processos retornada | | data.results\[x].id | String | Identificador da consulta | | data.results\[x].matchedWords | Array | Palavras-chave encontradas neste processo | | data.results\[x].criminalCategory | String | Categoria do processo | | data.results\[x].lawsuitClass | String | Classe | | data.results\[x].distributionDate | String | Data de distribuição | | data.results\[x].statusDate | String | Data do status | | data.results\[x].lawsuitDegree | String | Grau do processo | | data.results\[x].physicalLocation | String | Localização física | | data.results\[x].oldLawsuitNumber | String | Número antigo do processo | | data.results\[x].judgingBody | String | Juízo de origem | | data.results\[x].lawsuitId | String | Número do processo | | data.results\[x].isDigitalLawsuit | Boolean | Se o processo é digital | | data.results\[x].lawBranch | String | Área do Direito | | data.results\[x].segment | String | Segmento | | data.results\[x].isJusticeSecret | Boolean | Se é segredo de justiça | | data.results\[x].complementaryStatus | String | Status complementar | | data.results\[x].observationStatus | String | Status da observação | | data.results\[x].court | String | Tribunal | | data.results\[x].state | String | ESTADO | | data.results\[x].sourceUnit | String | Unidade de origem | | data.results\[x].lawsuitUrl | String | URL do processo | | data.results\[x].lawsuitValue | Objeto | Valor do processo retornado | | data.results\[x].lawsuitValue.currency | String | Moeda (R$, U$, etc) | | data.results\[x].lawsuitValue.value | Number | Valor | | data.results\[x].subjects | Array de strings | Lista de assuntos | | data.results\[x].moves | Array | Lista de movimentações do processo | | data.results\[x].moves\[x].date | String | Data da movimentação | | data.results\[x].moves\[x].description | String | Descrição da movimentação | | data.results\[x].actives | Array | Lista de ativos | | data.results\[x].actives\[x].cnpj | String | CNPJ | | data.results\[x].actives\[x].cpf | String | CPF | | data.results\[x].actives\[x].name | String | Nome | | data.results\[x].actives\[x].type | String | Tipo | | data.results\[x].actives\[x].lawyers | Array | Lista de advogados | | data.results\[x].actives\[x].lawyers\[x].oab | String | Número da OAB | | data.results\[x].actives\[x].lawyers\[x].name | String | Nome | | data.results\[x].actives\[x].lawyers\[x].cpf | String | CPF | | data.results\[x].passives | Array | Lista de passivos | | data.results\[x].passives\[x].cnpj | String | CNPJ | | data.results\[x].passives\[x].cpf | String | CPF | | data.results\[x].passives\[x].name | String | Nome | | data.results\[x].passives\[x].type | String | Tipo | | data.results\[x].passives\[x].lawyers | Array | Lista de advogados | | data.results\[x].passives\[x].lawyers\[x].oab | String | Número da OAB | | data.results\[x].passives\[x].lawyers\[x].name | String | Nome | | data.results\[x].passives\[x].lawyers\[x].cpf | String | CPF | | data.results\[x].otherParties | Array | Lista de outras partes | | data.results\[x].otherParties\[x].cnpj | String | CNPJ | | data.results\[x].otherParties\[x].cpf | String | CPF | | data.results\[x].otherParties\[x].name | String | Nome | | data.results\[x].otherParties\[x].type | String | Tipo | | data.results\[x].otherParties\[x].lawyers | Array | Lista de advogados | | data.results\[x].otherParties\[x].lawyers\[x].oab | String | Número da OAB | | data.results\[x].otherParties\[x].lawyers\[x].name | String | Nome | | data.results\[x].otherParties\[x].lawyers\[x].cpf | String | CPF | | data.results\[x].authorType | String | Tipo do autor | | data.results\[x].authorParty | String | Parte autora | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso", "total": 7, "foundWords": [ "XXXXX" ], "results": [ { "id": "XXXXXXXXfdda79638XXXXX", "matchedWords": [ "XXXXX" ], "criminalCategory": "XXXXXXXXXXXXXXXXXXXXXXXXXX", "lawsuitClass": "AÇÃO PENAL PROCEDIMENTO ORDINÁRIO", "distributionDate": "2017-11-24", "statusDate": "", "lawsuitDegree": "1", "physicalLocation": "", "oldLawsuitNumber": "", "judgingBody": "VARA ÚNICA", "lawsuitId": "XXXXXX", "isDigitalLawsuit": false, "lawBranch": "CÍVEL / ADMINISTRATIVO", "segment": "JUSTIÇA ESTADUAL", "isJusticeSecret": false, "complementaryStatus": "EM ANDAMENTO", "observationStatus": "ATIVO", "court": "TJ PA", "state": "PA", "sourceUnit": "XXXXX", "subjects": ["XXXXX"], "moves": [ { "date": "2018-06-19", "description": "NOTIFICAÇÃO DE NÃO CUMPRIMENTO DE ALVARÁ DE SOLTURA" }, { "date": "2018-05-25", "description": "MANDADO DE INTIMAÇÃO" }, { "date": "2018-05-25", "description": "ALVARÁ DE SOLTURA" }, { "date": "2018-05-23", "description": "A SECRETARIA DE ORIGEM" }, { "date": "2018-05-23", "description": "DECISÃO" } ], "actives": [ { "cnpj": "XXXXXX", "name": "MINISTÉRIO PÚBLICO ESTADUAL", "type": "PROMOTOR(A)" }, { "cpf": "XXX.XXX.XXX-XX", "name": "XXXXXX", "type": "VÍTIMA" } ], "passives": [ { "cpf": "XXX.XXX.XXX-XX", "name": "XXXXXX", "type": "RÉU" } ], "otherParties": [ { "cpf": "XXX.XXX.XXX-XX", "name": "XXXXXX", "type": "AGRAVANTE" } ], "authorType": "RÉU", "authorParty": "PASSIVO" } ] } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ------------------------ | ----------------------------------------------------------------------------------------------- | | has\_processes\_keywords | A regra ficará inválida se alguma das palavras-chave configuradas for encontrada nos processos. | | {% endtab %} | | | {% endtabs %} | | ## KYC e Compliance (PF17) Esta fonte inclui informações necessárias para atender aos requisitos regulatórios e legais relacionados aos processos de KYC (know your client). Ela fornece dados sobre pessoas politicamente expostas (PEPs), sanções e restrições, tanto em âmbito nacional quanto internacional. O conjunto de dados inclui sinalizadores que indicam se uma pessoa é PEP ou possui alguma restrição associada, além de registros históricos dessas situações. Se alguém foi PEP no passado, o sinalizador não ficará marcado, mas o registro histórico ainda estará disponível para análise. lista de bases de dados que consultamos: * Acordos de Leniência (Controladoria-Geral da União) * Banco Central - Inabilitados * Sanções do Canadá * CEAF * CEIS * CEPIM * CNEP * COAF * Conselho Nacional de Justiça * CVM - Alerta de Suspensão * CVM - Penalidade Temporária * CVM - Termo de Compromisso * Embargos do Ibama * União Europeia * FBI * GOVUK * Banco de Impedidos de Licitar e Contratar * INTERPOL * Inidôneos TCU (Tribunal de Contas da União) * MTE (Trabalho Escravo) * OFAC * Processo Administrativo Disciplinar (BSM Supervisão) * SEAPE-DF * Tribunal de Contas do Estado de São Paulo * Conselho de Segurança da ONU **Seção:** `pfKycCompliance` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ------------------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------- | | código de status | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/connect/transactions/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.pepHistory | Array | Lista de objetos com histórico de exposição política | | data.pepHistory\[x].level | String | Nível de PEP (Pessoa Politicamente Exposta) | | data.pepHistory\[x].jobTitle | String | Cargo | | data.pepHistory\[x].department | String | Departamento | | data.pepHistory\[x].motive | String | Motivo | | data.pepHistory\[x].cpf | String | CPF | | data.pepHistory\[x].source | String | Fonte | | data.pepHistory\[x].link | String | Link | | data.pepHistory\[x].startDate | String | Data em que a pessoa se tornou uma SPP | | data.pepHistory\[x].endDate | String | Data em que a pessoa deixou de ser uma SPP | | data.pepHistory\[x].creationDate | String | Data de criação | | data.pepHistory\[x].lastUpdateDate | String | Data da última atualização | | data.sanctionsHistory | Array | Lista de objetos com histórico de sanções e restrições | | data.sanctionsHistory\[x].source | String | Fonte da sanção | | data.sanctionsHistory\[x].type | String | Tipo de sanção | | data.sanctionsHistory\[x].matchRate | String | Indicação de quão semelhante é o nome | | data.sanctionsHistory\[x].startDate | String | Data de início | | data.sanctionsHistory\[x].endDate | String | Data de término | | data.sanctionsHistory\[x].originalName | String | Nome original associado à pessoa | | data.sanctionsHistory\[x].sanctionName | String | Nome registrado na lista internacional de sanções | | data.sanctionsHistory\[x].nationalities | String | Nacionalidades associadas à pessoa | | data.sanctionsHistory\[x].image | String | Foto da pessoa | | data.sanctionsHistory\[x].height | String | Altura da pessoa | | data.sanctionsHistory\[x].eyes | String | Cor dos olhos | | data.sanctionsHistory\[x].hair | String | Cor do cabelo | | data.sanctionsHistory\[x].distinguishingMarks | String | Características | | data.sanctionsHistory\[x].description | String | Descrição geral da sanção | | data.sanctionsHistory\[x].considerations | String | Considerações sobre a sanção | | data.isCurrentlyPEP | Boolean | Indica se a pessoa atualmente é uma PEP | | data.isCurrentlySanctioned | Boolean | Indica se a pessoa atualmente está sob alguma sanção | | data.last30DaysSanctions | Number | Número de sanções e restrições encontradas nos últimos 30 dias | | data.last90DaysSanctions | Number | Número de sanções e restrições encontradas nos últimos 90 dias | | data.last180DaysSanctions | Number | Número de sanções e restrições encontradas nos últimos 180 dias | | data.last365DaysSanctions | Number | Número de sanções e restrições encontradas nos últimos 365 dias | | data.lastYearPEPOccurence | Number | Número de registros de PEP encontrados no último ano | | data.last3YearsPEPOccurence | Number | Número de registros de PEP encontrados nos últimos 3 anos | | data.last5YearsPEPOccurence | Number | Número de registros de PEP encontrados nos últimos 5 anos | | data.last5PlusYearsPEPOccurence | Number | Número de registros de PEP encontrados há 5 anos ou mais | | data.firstPEPOccurenceDate | String | Data do primeiro registro de PEP encontrado para a pessoa | | data.lastPEPOccurenceDate | String | Data do último registro de PEP encontrado para o indivíduo | | data.isCurrentlyElectoralDonor | Boolean | Indica se a pessoa faz doações para campanhas políticas | | data.isHistoricalElectoralDonor | Boolean | Indica se a pessoa já fez doações para campanhas políticas | | data.totalElectoralDonationsLastTwoElections | Number | Número de doações feitas nos últimos dois ciclos eleitorais | | data.totalElectoralDonations | Number | Valor total das doações feitas | | data.totalElectoralDonationAmountLastTwoElections | Number | Soma do valor doado nos últimos dois ciclos eleitorais | | data.totalElectoralDonationAmount | Number | Valor total doado | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso", "pepHistory": [ { "level": "1", "jobTitle": "VEREADOR (SUPLENTE)", "department": "XX XXXX XX", "motive": "FUNCIONÁRIO MUNICIPAL", "source": "TSE", "startDate": "2017-01-01T00:00:00Z", "endDate": "2025-12-31T00:00:00Z", "creationDate": "2022-11-17T01:03:54Z", "lastUpdateDate": "2022-11-17T01:03:54Z" }, { "level": "1", "jobTitle": "VEREADOR", "department": "CÂMARA MUNICIPAL DE XXX", "motive": "FUNCIONÁRIO MUNICIPAL", "source": "http://caf.io", "startDate": "2016-01-01T00:00:00+00:00", "endDate": "2025-01-01T00:00:00+00:00", "creationDate": "2019-01-21T12:11:02.589Z", "lastUpdateDate": "2020-06-18T15:16:09.235Z" } ], "sanctionsHistory": [] } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ------------------ | ----------------------------------------------------------------- | | has\_no\_sanctions | Verifique se não foram encontradas sanções em listas restritivas. | | has\_no\_pep | Verifica se o titular do CPF ou CNPJ possui exposição política. | | {% endtab %} | | {% tab title="Dados de teste beta" %} | CPF | DESCRIÇÃO | Código de status | | ------------- | ----------------------------- | ---------------- | | 19321675019 | TEMPO ESGOTADO | 50 | | 98302514705 | INVÁLIDO | 02 | | 23993556011 | MENOR DE 18 ANOS | 02 | | 59872132070 | MENOR DE 12 ANOS | 02 | | 40442820135 | REGULAR | 01 | | 63017285995 | REGULAR | 01 | | 91708635203 | REGULAR | 01 | | 58136053391 | REGULAR | 01 | | 20751061000 | COM SANÇÃO | 01 | | 72713429072 | COM PEPs | 01 | | 46227846023 | É DOADOR ELEITORAL ATUALMENTE | 01 | | 46227846023 | É DOADOR ELEITORAL HISTÓRICO | 01 | | 30078021057 | FOI SANCIONADO ANTERIORMENTE | 01 | | {% endtab %} | | | | {% endtabs %} | | | ## Notícias relacionadas (PF25) Retorna notícias públicas relacionadas a esta pessoa na internet. Levando em conta que a busca é textual e considera o nome, é necessário cuidado adicional com homônimos. **Seção:** `pfMediaProfileAndExposure` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- | | código de status | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/connect/transactions/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.mediaExposureLevel | String | Nível de exposição na mídia | | data.celebrityLevel | String | Nível de celebridade | | data.unpopularityLevel | String | Nível de impopularidade | | data.newsItems | Array | Lista de notícias capturadas para a entidade | | data.newsItems\[x].title | String | Título da notícia | | data.newsItems\[x].sourceName | String | Nome da fonte responsável pela notícia | | data.newsItems\[x].url | String | URL da notícia | | data.newsItems\[x].sentimentAnalysis | Objeto | Análise de sentimento | | data.newsItems\[x].sentimentAnalysis.label | String | Rótulo (positivo, negativo) atribuído ao conteúdo em geral | | data.newsItems\[x].sentimentAnalysis.peopleCount | String | Número de pessoas identificadas no conteúdo | | data.newsItems\[x].sentimentAnalysis.placesCount | String | Número de locais identificados no conteúdo | | data.newsItems\[x].sentimentAnalysis.organizationsCount | String | Número de empresas identificadas no conteúdo | | data.newsItems\[x].sentimentAnalysis.entities | Objeto | Dicionário com nomes de entidades e rótulos do conteúdo | | data.newsItems\[x].categories | Array | Lista de categorias da notícia | | data.newsItems\[x].captureDate | String | Data em que a notícia foi capturada | | data.newsItems\[x].publicationDate | String | Data de publicação da notícia | | data.creationDate | String | Data de criação | | data.lastUpdateDate | String | Data da última atualização | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso", "mediaExposureLevel": "G", "celebrityLevel": "G", "unpopularityLevel": "H", "newsItems": [ { "title": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "sourceName": "XXXXXXXXXXX", "url": "https://caf.io", "sentimentAnalysis": { "label": "POSITIVO", "peopleCount": "13", "placesCount": "3", "organizationsCount": "4", "entities": { "PEOPLE": { "XXXX XXXXXXX": { "Label": "LEVEMENTE_POSITIVO" }, "XXXX XXXXXXX": { "Label": "POSITIVO" } }, "PLACES": { "BRASIL": { "Label": "LEVEMENTE_POSITIVO" }, "AMERICA LATINA": { "Label": "LEVEMENTE_POSITIVO" } }, "ORGANIZATIONS": { "XXXXXXX": { "Label": "POSITIVO" }, "XXXXXXX": { "Label": "LEVEMENTE_POSITIVO" } } } }, "categories": ["economia"], "captureDate": "2018-11-03T07:08:47.138Z", "publicationDate": "2014-10-02T08:02:00Z" } ], "creationDate": "2012-09-17T18:42:00Z", "lastUpdateDate": "2022-08-04T08:29:08.738Z" } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ------------------------ | ---------------------------------------------------- | | has\_no\_media\_exposure | Verifica se o titular do CPF tem exposição na mídia. | | {% endtab %} | | | {% endtabs %} | | ## Protocolos processuais no CADE Verifique o site do CADE (Conselho Administrativo de Defesa Econômica) e confira se o CPF consultado possui protocolos processuais vinculados. **Seção:** `pfProcessOnCade` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- | | código de status | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/connect/transactions/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.proceduralProtocols | Array | Lista de protocolos encontrados para o cpf consultado | | data.proceduralProtocols\[x].demandOrigin | String | Origem da consulta | | data.proceduralProtocols\[x].protocolNumber | String | Número do protocolo | | data.proceduralProtocols\[x].source | String | Unidade geradora | | data.proceduralProtocols\[x].emissionDate | String | Data de emissão | | data.proceduralProtocols\[x].documentRequested | String | Documento solicitado | | data.proceduralProtocols\[x].documentRequestedUrl | String | URL do documento solicitado | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso. Não foram encontrados protocolos vinculados ao documento informado." } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ---------------------- | ------------------------------------------------------------------ | | has\_process\_on\_cade | A regra será inválida se houver protocolos processuais com o CADE. | | {% endtab %} | | | {% endtabs %} | | ## Lista de sanções do OFAC Pesquise a lista de Nacionais Especialmente Designados e Pessoas Bloqueadas (SDN) do Office of Foreign Assets Control (OFAC). A consulta é feita por nome e é uma consulta internacional. **Seção:** `pfOfacSanctionsList` **Parâmetro obrigatório:** `name` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ----------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- | | código de status | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/connect/transactions/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.sanctionsList | Array | Lista de protocolos encontrados para o cpf consultado | | data.sanctionsList\[x].type | String | Tipo | | data.sanctionsList\[x].firstName | String | Nome | | data.sanctionsList\[x].lastName | String | Sobrenome | | data.sanctionsList\[x].title | String | Título | | data.sanctionsList\[x].dateOfBirth | String | Data de nascimento | | data.sanctionsList\[x].placeOfBirth | String | Local de nascimento | | data.sanctionsList\[x].list | String | Lista à qual o nome pertence | | data.sanctionsList\[x].program | String | Programa ao qual o nome pertence | | data.sanctionsList\[x].remarks | String | Observações | | data.sanctionsList\[x].nationality | String | Nacionalidade | | data.sanctionsList\[x].citizenship | String | Cidadania | | data.sanctionsList\[x].identifications | Array | Lista de identificações conhecidas do nome informado | | data.sanctionsList\[x].identifications\[x].type | String | Tipo de identificação | | data.sanctionsList\[x].identifications\[x].number | String | Número do documento | | data.sanctionsList\[x].identifications\[x].country | String | País de origem do documento | | data.sanctionsList\[x].identifications\[x].issueDate | String | Data de emissão do documento | | data.sanctionsList\[x].identifications\[x].expireDate | String | Data de expiração do documento | | data.sanctionsList\[x].aliases | Array | Lista de sobrenomes pelos quais o nome informado também pode ser identificado | | data.sanctionsList\[x].aliases\[x].type | String | Tipo de sobrenome | | data.sanctionsList\[x].aliases\[x].category | String | Categoria do sobrenome | | data.sanctionsList\[x].aliases\[x].name | String | Nome ou sobrenome (pode ser documento falso) | | data.sanctionsList\[x].addresses | Array | Lista de endereços conhecidos para o nome informado | | data.sanctionsList\[x].addresses\[x].address | String | Endereço | | data.sanctionsList\[x].addresses\[x].city | String | Cidade | | data.sanctionsList\[x].addresses\[x].stateOrProvince | String | Estado ou província | | data.sanctionsList\[x].addresses\[x].postalCode | String | Código postal (CEP) | | data.sanctionsList\[x].addresses\[x].country | String | País | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso. Nenhum resultado encontrado para esta busca." } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ----------------------------- | ------------------------------------------------------------ | | is\_on\_ofac\_sanctions\_list | Verifica se há algum registro no OFAC para o nome informado. | | {% endtab %} | | | {% endtabs %} | | ## Lista privada de restrição (PF78) Consulta a presença na lista privada de restrições. **Seção:** `pfDenyListPrivate` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ---------------- | ------- | --------------------------------------------------------------------------------------------------------------------------- | | código de status | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/connect/transactions/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.recordFound | Boolean | Indicação de presença na lista privada de restrição | | data.cpf | String | CPF | | data.name | String | Nome | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso", "recordFound": false } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ------------------- | -------------------------------------------------------------------- | | its\_on\_deny\_list | A regra será inválida se o CPF/CNPJ consultado estiver na Deny List. | | {% endtab %} | | | {% endtabs %} | | ## Pessoas impedidas de apostar - Relacionamento esportivo (PF79) Retorna se o CPF consultado pertence a uma pessoa impedida de apostar ou com possível vínculo com uma pessoa impedida de apostar, fornecendo o nível de relacionamento, equipe, ano, atividade e outras informações. **Seção:** `peopleSportRelated` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ---------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- | | código de status | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/connect/transactions/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.sportsRelationshipType | Array | Indica o tipo de relacionamento que a pessoa tem com o esporte | | data.sport | Array | Indica o tipo de esporte ao qual a pessoa encontrada está relacionada | | data.documentType | String | Tipo de documento encontrado | | data.name | String | Nome da pessoa relacionada ao esporte | | data.relationship | String | Indica o tipo de relacionamento, no caso de terceiros com o atleta | | data.relationshipDocument | String | CPF da pessoa relacionada ao atleta | | data.relationshipType | Array | Tipo de relacionamento do atleta com o esporte | | data.relationshipName | String | Nome do atleta relacionado à terceira pessoa | | data.sportsEntity | String | Indica a entidade à qual o atleta está relacionado | | data.sportLastBondYear | String | Ano do último vínculo com o esporte | | data.updateDate | String | Indica a data em que o registro de relacionamento foi atualizado | | data.tournaments | Array | Torneios nos quais o atleta está envolvido | | data.tournaments\[x].team | String | Nome da equipe | | data.tournaments\[x].year | String | Ano do torneio | | data.tournaments\[x].name | String | Nome do torneio | | data.sportRadarRef | Array | Nome e IDs associados ao clube atual do atleta no Sportsradar | | data.sportRadarRef\[x].name | String | Nome da equipe | | data.sportRadarRef\[x].srIds | Array | IDs associados | | data.sportRadarRef\[x].name | String | Ano | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "código": "01", "data": { "message": "Consulta realizada com sucesso.", "sportsRelationshipType": ["jogador"], "sport": ["futebol"], "documentType": "cpf", "name": "Davi Ruinzinho Duarte", "relationship": "", "relationshipDocument": "", "relationshipType": [], "relationshipName": "", "sportsEntity": "Tabajara Futebol Clube", "sportLastBondYear": "2024", "updateDate": "2024-01-01", "tournaments": [ { "team": "Tabajara Futebol Clube", "year": "2024", "name": "Campeonato Brasileiro Serie Z" } ], "sportRadarRef": [ { "name": "Tabajara Futebol Clube", "srIds": [32769, 354040], "year": "2024" } ] } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | -------------------------- | ---------------------------------------------------- | | is\_sport\_related\_person | Verifica se o indivíduo está relacionado a esportes. | | {% endtab %} | | | {% endtabs %} | | ## Pessoas impedidas de apostar - Relacionamento esportivo + casas de apostas + Ministério da Fazenda (PF80) Esta fonte consolida informações de fontes públicas relacionadas a atividades esportivas, casas de apostas e dados do Ministério da Fazenda. Ela verifica se o CPF informado está associado a outras pessoas, identifica o grau de relacionamento entre elas e fornece informações adicionais relevantes. **Seção:** `peopleComplianceBet` **Parâmetro obrigatório:** `cpf` **Parâmetro opcional:** `birthDate` *Esta informação é exigida em algumas fontes para concluir a execução de menores* {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ---------------------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | código de status | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/connect/transactions/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.queryDate | String | Data em que a consulta foi executada | | data.queryId | String | Identificador único da consulta | | data.results | Array | Resultados da consulta | | data.results\[x].matchKeys | String | Chaves usadas para correspondência da consulta | | data.results\[x].onlineBettingCompliance | Objeto | Dados de conformidade relacionados a apostas online | | data.results\[x].onlineBettingCompliance.sportsExposure | Objeto | Detalhes de exposição relacionados a esportes | | data.results\[x].onlineBettingCompliance.sportsExposure.sports | Array | Lista de esportes relacionados à consulta | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].sportName | String | Nome do esporte | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].region | String | Região relacionada ao esporte | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].totalRelatedEntities | Number | Número total de entidades relacionadas | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities | Array | Lista de entidades relacionadas ao esporte | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].docNumber | String | Número do documento da entidade relacionada | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].docType | String | Tipo de documento da entidade relacionada (CPF, RG) | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].relationshipLevel | String | Nível de relacionamento com a entidade (INDIRETO DE 1º NÍVEL, INDIRETO DE 2º NÍVEL, PARCEIRO COMERCIAL) | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].institutionName | String | Nome da instituição | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].institutionActivity | String | Atividade da instituição | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].role | String | Função da entidade (TREINADOR ASSISTENTE, TREINADOR, MEMBRO DO CONSELHO, DIRETOR, EX-PRESIDENTE, GERENTE, JOGADOR, PRESIDENTE, ÁRBITRO, EQUIPE, VICE-PRESIDENTE) | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].isActive | Boolean | Se a entidade está ativa | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].startDate | String | Data de início do relacionamento | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].endDate | String | Data de término do relacionamento | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].source | String | Fonte da informação de relacionamento | | data.results\[x].onlineBettingCompliance.forbiddenBet | Objeto | Dados relacionados à aposta proibida | | data.results\[x].onlineBettingCompliance.forbiddenBet.name | String | Nome da pessoa | | data.results\[x].onlineBettingCompliance.forbiddenBet.age | String | Idade da pessoa | | data.results\[x].onlineBettingCompliance.forbiddenBet.isFromMinisterioDaFazenda | Boolean | Se a pessoa é do Ministério da Fazenda | | data.results\[x].onlineBettingCompliance.forbiddenBet.isBookmakerOwner | Boolean | Se a pessoa é proprietária de uma casa de apostas | | data.results\[x].onlineBettingCompliance.forbiddenBet.bookmakerOwnerMotives | Array | Motivos para ser proprietária de uma casa de apostas | | data.results\[x].onlineBettingCompliance.forbiddenBet.bookmakerOwnerMotives\[x].source | String | Fonte da informação | | data.results\[x].onlineBettingCompliance.forbiddenBet.bookmakerOwnerMotives\[x].cnpj | String | CNPJ da empresa relacionada | | data.results\[x].onlineBettingCompliance.forbiddenBet.bookmakerOwnerMotives\[x].companyName | String | Nome da empresa relacionada | | data.results\[x].onlineBettingCompliance.forbiddenBet.bookmakerOwnerMotives\[x].economicActivityCodes | String | Códigos de atividade econômica da empresa | | data.results\[x].onlineBettingCompliance.forbiddenBet.bookmakerOwnerMotives\[x].additionalDetails | Objeto | Detalhes adicionais da empresa | | data.results\[x].onlineBettingCompliance.forbiddenBet.ministryOfFazendaMotives | Objeto | Detalhes do Ministério da Fazenda | | data.evidence | Array | Lista de evidências relacionadas à consulta | | data.evidence\[x].id | String | Identificador único da evidência | | data.evidence\[x].source | String | Fonte da evidência | | data.status | Objeto | Status das verificações de conformidade | | data.status.onlineBettingCompliance | Array | Lista de mensagens de status da conformidade com apostas on-line | | data.status.onlineBettingCompliance\[x].code | Number | Código de status da verificação de conformidade | | data.status.onlineBettingCompliance\[x].message | String | Mensagem de status da verificação de conformidade | | data.elapsedMilliseconds | Number | Tempo gasto para executar a consulta, em milissegundos | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "data": { "message": "Consulta realizada com sucesso.", "results": [ { "matchKeys": "doc{12345678910}", "onlineBettingCompliance": { "sportsExposure": { "sports": [ { "sportName": "FUTEBOL", "region": "EUROPA", "totalRelatedEntities": 2, "relatedEntities": [ { "relationshipLevel": "DIRETO", "institutionName": "Barcelona", "institutionActivity": "CLUBES SOCIAIS, ESPORTIVOS E SIMILARES", "isActive": false, "startDate": "2014-07-01T00:00:00Z", "endDate": "2020-08-30T00:00:00Z", "source": "BIDUEFA" }, { "relationshipLevel": "DIRETO", "institutionName": "PSG", "institutionActivity": "CLUBES SOCIAIS, ESPORTIVOS E SIMILARES", "isActive": true, "startDate": "2020-09-01T00:00:00Z", "endDate": null, "source": "BIDLFP" } ] } ] }, "forbiddenBet": { "name": "LIONEL SILVA", "age": "36", "isBookmakerOwner": false, "bookmakerOwnerMotives": [], "isFromMinisterioDaFazenda": false } } } ], "status": { "onlineBettingCompliance": [ { "code": 0, "message": "OK" } ] }, "elapsedMilliseconds": 123, "evidence": [], "message": "Consulta realizada com sucesso.", "queryDate": "2024-12-10T13:45:00.123Z", "queryId": "abcd1234-5678-90ef-ghij-klmnopqrstuv" } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | is\_prevented\_from\_betting | Verifica se o indivíduo está legalmente impedido de fazer apostas, ou seja, se tem qualquer ligação com casas de apostas, com o setor esportivo ou com o Ministério da Fazenda. | | {% endtab %} | | | {% endtabs %} | | ## Processos - NOVO (PF52) Retorna todos os processos judiciais disponíveis por meio de uma consulta expandida, garantindo a cobertura máxima de informações. **Seção:** `pfLegalRecordsExtended` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | -------------------------------------------------------------------- | ------- | ------------------------------------ | | código de status | String | Consultar status | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.lawsuits | Array | Lista de processos retornada | | data.lawsuits\[x].cnjCode | String | Código CNJ | | data.lawsuits\[x].secrecyLevel | Number | Nível de sigilo | | data.lawsuits\[x].amount | Number | Valor do processo | | data.lawsuits\[x].area | String | Área do processo | | data.lawsuits\[x].instance | Number | Grau do processo | | data.lawsuits\[x].phase | String | Fase do processo | | data.lawsuits\[x].status | String | Status do processo | | data.lawsuits\[x].judge | String | Juiz do processo | | data.lawsuits\[x].name | String | Abreviação das partes | | data.lawsuits\[x].courtAcronym | String | Sigla do tribunal | | data.lawsuits\[x].courtDistrict | String | Comarca | | data.lawsuits\[x].state | String | Estado do processo | | data.lawsuits\[x].city | String | Cidade do processo | | data.lawsuits\[x].distributionDate | String | Data de distribuição | | data.lawsuits\[x].justiceDescription | String | Descrição da justiça | | data.lawsuits\[x].isCriminal | Boolean | Indicação de processo criminal | | data.lawsuits\[x].mainPartySide | String | Lado da parte pesquisada | | data.lawsuits\[x].lastStep | Objeto | Último andamento do processo | | data.lawsuits\[x].lastStep.stepId | String | Identificador do último andamento | | data.lawsuits\[x].lastStep.stepDate | String | Data do último andamento | | data.lawsuits\[x].lastStep.content | String | Conteúdo do último andamento | | data.lawsuits\[x].lastStep.stepType | String | Tipo do último andamento | | data.lawsuits\[x].lastStep.stepsCount | Number | Quantidade de últimos andamentos | | data.lawsuits\[x].relatedLawsuits | Array | Processos relacionados | | data.lawsuits\[x].relatedLawsuits\[x].code | String | Código dos processos relacionados | | data.lawsuits\[x].relatedLawsuits\[x].instance | String | Instância dos processos relacionados | | data.lawsuits\[x].steps | Array | Andamentos | | data.lawsuits\[x].steps\[x].stepDate | String | Data do andamento | | data.lawsuits\[x].steps\[x].stepType | String | Tipo do andamento | | data.lawsuits\[x].steps\[x].content | String | Conteúdo do andamento | | data.lawsuits\[x].steps\[x].private | String | Andamento sigiloso | | data.lawsuits\[x].subjects | Array | Assuntos | | data.lawsuits\[x].subjects\[x].code | String | Código do assunto | | data.lawsuits\[x].subjects\[x].subject | String | Descrição do assunto | | data.lawsuits\[x].courts | Array | Tribunais | | data.lawsuits\[x].courts\[x].code | String | Código do tribunal | | data.lawsuits\[x].courts\[x].court | String | Descrição do tribunal | | data.lawsuits\[x].classifications | Array | Classificações | | data.lawsuits\[x].classifications\[x].code | String | Código da classificação | | data.lawsuits\[x].classifications\[x].classification | String | Descrição da classificação | | data.lawsuits\[x].parties | Array | Partes | | data.lawsuits\[x].parties\[x].type | String | Tipo da parte | | data.lawsuits\[x].parties\[x].side | String | Lado da parte | | data.lawsuits\[x].parties\[x].party | String | Descrição da parte | | data.lawsuits\[x].parties\[x].mainDocument | String | Documento principal da parte | | data.lawsuits\[x].parties\[x].documents | Array | Documentos da parte | | data.lawsuits\[x].parties\[x].documents\[x].documentType | String | Tipo de documento da parte | | data.lawsuits\[x].parties\[x].documents\[x].document | String | Documento da parte | | data.lawsuits\[x].parties\[x].lawyers | Array | Advogados da parte | | data.lawsuits\[x].parties\[x].lawyers\[x].name | String | Nome do advogado | | data.lawsuits\[x].parties\[x].lawyers\[x].mainDocument | String | Documento principal dos advogados | | data.lawsuits\[x].parties\[x].lawyers\[x].documents | Array | Documentos dos advogados | | data.lawsuits\[x].parties\[x].lawyers\[x].documents\[x].documentType | String | Tipo de documento dos advogados | | data.lawsuits\[x].parties\[x].lawyers\[x].documents\[x].document | String | Documento dos advogados | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "message": "Consulta realizada com sucesso", "data": { "lawsuits": [ { "cnjCode": "099999-09.0990.9.99.9900", "secrecyLevel": 0, "amount": 1000, "area": "DIREITO PROCESSUAL CIVIL", "status": "Ativo", "phase": "Inicial", "judge": "", "instance": 1, "name": "JONH DOE X JANE DOE", "courtAcronym": "TJSP", "courtDistrict": "VARA DA COMARCA DE SÃO PAULO", "state": "sp", "city": "SÃO PAULO", "distributionDate": "2024-03-12T09:57:51.000Z", "justiceDescription": "JUSTIÇA ESTADUAL", "isCriminal": false, "mainPartySide": "ATIVO", "steps": [], "subjects": [ { "code": "10671", "subject": "Obrigação de Fazer / Não Fazer" } ], "courts": [ { "code": "5117", "court": "VARA DA COMARCA DE SÃO PAULO" } ], "classifications": [ { "code": "436", "classification": "" } ], "parties": [ { "type": "Réu", "side": "Passivo", "party": "JANE DOE", "mainDocument": "99999999999", "documents": [ { "documentType": "cpf", "document": "99999999999" } ], "lawyers": [ { "name": "JOSE DOE", "mainDocument": "", "documents": [] } ] }, { "type": "Autor", "side": "Ativo", "party": "JOHN DOE", "mainDocument": "88888888888", "documents": [ { "documentType": "cpf", "document": "88888888888" } ], "lawyers": [ { "name": "JOÃO DOE", "mainDocument": "", "documents": [] } ] }, { "type": "Advogado", "side": "Passivo", "party": "JOSE DOE", "mainDocument": "", "documents": [], "lawyers": [] }, { "type": "Advogado", "side": "Ativo", "party": "JOÃO DOE", "mainDocument": "", "documents": [], "lawyers": [] } ] } ] } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ------------------------------------------------ | ---------------------------------------------------------------------- | | has\_no\_processes | Verifica se o CPF/CNPJ está vinculado a processos. | | has\_no\_processes\_active\_party | Verifica se o CPF está vinculado a processos como parte ativa. | | has\_no\_processes\_passive\_party | Verifica se o CPF está vinculado a processos como parte passiva. | | has\_no\_processes\_other\_party | Verifica se o CPF está vinculado a processos como outras partes. | | has\_no\_defendant\_processes | Verifica se o CPF/CNPJ está vinculado a processos como réu. | | has\_no\_criminal\_processes | Verifica se o CPF/CNPJ está vinculado a processos criminais. | | has\_author\_type\_null\_in\_criminal\_processes | Verifica se há um campo 'authorType' vazio em algum processo criminal. | | {% endtab %} | | | {% endtabs %} | | ## Processos com palavras-chave - NOVO (PF53) Retorna todos os processos judiciais disponíveis por meio de uma consulta expandida, garantindo a cobertura máxima de informações. **Seção:** `pfLegalRecordsExtendedKeywords` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | -------------------------------------------------------------------- | ------- | ----------------------------------------- | | código de status | String | Consultar status | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.foundKeywords | Array | Palavras-chave encontradas | | data.lawsuits | Array | Lista de processos retornada | | data.lawsuits\[x].matchedWords | Array | Palavras-chave encontradas neste processo | | data.lawsuits\[x].cnjCode | String | Código CNJ | | data.lawsuits\[x].secrecyLevel | Number | Nível de sigilo | | data.lawsuits\[x].amount | Number | Valor do processo | | data.lawsuits\[x].area | String | Área do processo | | data.lawsuits\[x].instance | Number | Grau do processo | | data.lawsuits\[x].phase | String | Fase do processo | | data.lawsuits\[x].status | String | Status do processo | | data.lawsuits\[x].judge | String | Juiz do processo | | data.lawsuits\[x].name | String | Abreviação das partes | | data.lawsuits\[x].courtAcronym | String | Sigla do tribunal | | data.lawsuits\[x].courtDistrict | String | Comarca | | data.lawsuits\[x].state | String | Estado do processo | | data.lawsuits\[x].city | String | Cidade do processo | | data.lawsuits\[x].distributionDate | String | Data de distribuição | | data.lawsuits\[x].justiceDescription | String | Descrição da justiça | | data.lawsuits\[x].isCriminal | Boolean | Indicação de processo criminal | | data.lawsuits\[x].mainPartySide | String | Lado da parte pesquisada | | data.lawsuits\[x].lastStep | Objeto | Último andamento do processo | | data.lawsuits\[x].lastStep.stepId | String | Identificador do último andamento | | data.lawsuits\[x].lastStep.stepDate | String | Data do último andamento | | data.lawsuits\[x].lastStep.content | String | Conteúdo do último andamento | | data.lawsuits\[x].lastStep.stepType | String | Tipo do último andamento | | data.lawsuits\[x].lastStep.stepsCount | Number | Quantidade de últimos andamentos | | data.lawsuits\[x].relatedLawsuits | Array | Processos relacionados | | data.lawsuits\[x].relatedLawsuits\[x].code | String | Código dos processos relacionados | | data.lawsuits\[x].relatedLawsuits\[x].instance | String | Instância dos processos relacionados | | data.lawsuits\[x].steps | Array | Andamentos | | data.lawsuits\[x].steps\[x].stepDate | String | Data do andamento | | data.lawsuits\[x].steps\[x].stepType | String | Tipo do andamento | | data.lawsuits\[x].steps\[x].content | String | Conteúdo do andamento | | data.lawsuits\[x].steps\[x].private | String | Andamento sigiloso | | data.lawsuits\[x].subjects | Array | Assuntos | | data.lawsuits\[x].subjects\[x].code | String | Código do assunto | | data.lawsuits\[x].subjects\[x].subject | String | Descrição do assunto | | data.lawsuits\[x].courts | Array | Tribunais | | data.lawsuits\[x].courts\[x].code | String | Código do tribunal | | data.lawsuits\[x].courts\[x].court | String | Descrição do tribunal | | data.lawsuits\[x].classifications | Array | Classificações | | data.lawsuits\[x].classifications\[x].code | String | Código da classificação | | data.lawsuits\[x].classifications\[x].classification | String | Descrição da classificação | | data.lawsuits\[x].parties | Array | Partes | | data.lawsuits\[x].parties\[x].type | String | Tipo da parte | | data.lawsuits\[x].parties\[x].side | String | Lado da parte | | data.lawsuits\[x].parties\[x].party | String | Descrição da parte | | data.lawsuits\[x].parties\[x].mainDocument | String | Documento principal da parte | | data.lawsuits\[x].parties\[x].documents | Array | Documentos da parte | | data.lawsuits\[x].parties\[x].documents\[x].documentType | String | Tipo de documento da parte | | data.lawsuits\[x].parties\[x].documents\[x].document | String | Documento da parte | | data.lawsuits\[x].parties\[x].lawyers | Array | Advogados da parte | | data.lawsuits\[x].parties\[x].lawyers\[x].name | String | Nome do advogado | | data.lawsuits\[x].parties\[x].lawyers\[x].mainDocument | String | Documento principal dos advogados | | data.lawsuits\[x].parties\[x].lawyers\[x].documents | Array | Documentos dos advogados | | data.lawsuits\[x].parties\[x].lawyers\[x].documents\[x].documentType | String | Tipo de documento dos advogados | | data.lawsuits\[x].parties\[x].lawyers\[x].documents\[x].document | String | Documento dos advogados | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "statusCode": "01", "message": "Consulta realizada com sucesso", "data": { "foundKeywords": [ "Indenização por dano moral" ], "lawsuits": [ { "type": "processo", "matchedWords": [ "Indenização por dano moral" ], "cnjCode": "099999-09.0990.9.99.9900", "secrecyLevel": 0, "amount": 1000, "area": "DIREITO PROCESSUAL CIVIL", "status": "Ativo", "phase": "Inicial", "judge": "", "instance": 1, "name": "JONH DOE X JANE DOE", "courtAcronym": "TJSP", "courtDistrict": "VARA DA COMARCA DE SÃO PAULO", "state": "sp", "city": "SÃO PAULO", "distributionDate": "2024-03-12T09:57:51.000Z", "justiceDescription": "JUSTIÇA ESTADUAL", "isCriminal": false, "mainPartySide": "ATIVO", "steps": [], "subjects": [ { "code": "10671", "subject": "Obrigação de Fazer / Não Fazer" }, { "code": "10001", "subject": "Indenização por dano moral" } ], "courts": [ { "code": "5117", "court": "VARA DA COMARCA DE SÃO PAULO" } ], "classifications": [ { "code": "436", "classification": "" } ], "parties": [ { "type": "Réu", "side": "Passivo", "party": "JANE DOE", "mainDocument": "99999999999", "documents": [ { "documentType": "cpf", "document": "99999999999" } ], "lawyers": [ { "name": "JOSE DOE", "mainDocument": "", "documents": [] } ] }, { "type": "Autor", "side": "Ativo", "party": "JOHN DOE", "mainDocument": "88888888888", "documents": [ { "documentType": "cpf", "document": "88888888888" } ], "lawyers": [ { "name": "JOÃO DOE", "mainDocument": "", "documents": [] } ] }, { "type": "Advogado", "side": "Passivo", "party": "JOSE DOE", "mainDocument": "", "documents": [], "lawyers": [] }, { "type": "Advogado", "side": "Ativo", "party": "JOÃO DOE", "mainDocument": "", "documents": [], "lawyers": [] } ] } ] } } ``` {% endtab %} {% tab title="Regras de validação" %} | Regra | Descrição | | ------------------------ | ----------------------------------------------------------------------------------------------- | | has\_processes\_keywords | A regra ficará inválida se alguma das palavras-chave configuradas for encontrada nos processos. | | {% endtab %} | | | {% endtabs %} | | --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.caf.io/caf-api/caf-api-pt-br/connect/transactions/background-check/kyc/risk.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.