> 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/api-core/transaction-details/background-check/kyc/risk.md). # Risco ## Antecedentes criminais - Polícia Federal (PF3) Emissão de certidão de antecedentes criminais pela Polícia Federal. **Seção:** `pfBackgroundCheckFederalPolice` **Parâmetro obrigatório:** `cpf, name, motherName, birthDate` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ---------------------- | ------ | --------------------------------------------------- | | statusCode | String | Consultar status | | dados | Objeto | Dados de retorno | | data.idNumber | String | CPF da pessoa | | data.status | String | Status do certificado (encontrado / não encontrado) | | data.certificateNumber | String | Número do certificado | | data.certificateText | String | Descrição do certificado (conteúdo) | | data.emissionDate | String | Data de emissão do certificado | | data.validity | String | Validade do certificado | | {% 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 | | ------------------------------------------ | -------------------------------------------------------------------------------------------------------- | | nao\_tem\_antecedentes\_criminais\_federal | A regra será inválida se o CPF tiver antecedentes criminais na Polícia Federal. | | nao\_tem\_dados\_inconsistentes | A regra se tornará inválida se houver inconsistência nos dados enviados para consulta à Polícia Federal. | | nao\_tem\_antecedentes\_criminais | Verifica se o CPF possui antecedentes criminais. | | {% endtab %} | | | {% endtabs %} | | ## Mandado de privaçã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 | | ---------------------------------- | ------ | ------------------------------------------------------------------------ | | statusCode | String | Consultar status | | dados | Objeto | Dados de retorno | | data.message | String | Descritivo com 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 | Data | | 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 | | ------------------------ | ------------------------------------------------------------------------------ | | tem\_mandado\_de\_prisao | Verifica a existência de mandados junto ao Conselho Nacional de Justiça (CNJ). | | {% endtab %} | | | {% endtabs %} | | ## Processos (PF48) Retorna informações detalhadas sobre processos 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 | | -------------------------------------------------- | ---------------- | ---------------------------------- | | statusCode | String | Consultar status | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.total | Número | Total de processos | | data.results | Array | Lista de processos retornados | | 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 | Órgão julgador | | data.results\[x].lawsuitId | String | Número do processo | | data.results\[x].isDigitalLawsuit | Booleano | Se o caso é digital | | data.results\[x].lawBranch | String | Ramo do Direito | | data.results\[x].segment | String | Segmento | | data.results\[x].isJusticeSecret | Booleano | 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 | Retorno do valor do processo | | data.results\[x].lawsuitValue.currency | String | Moeda (R$, U$, etc) | | data.results\[x].lawsuitValue.value | Número | 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 do autor | | {% 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 | | ------------------------------------------------- | ------------------------------------------------------------------ | | nao\_tem\_processos | Verifica se o CPF/CNPJ está vinculado a processos. | | nao\_tem\_processos\_parte\_ativa | Verifica se o CPF está vinculado a processos como parte ativa. | | nao\_tem\_processos\_parte\_passiva | Verifica se o CPF está vinculado a processos como parte passiva. | | nao\_tem\_processos\_parte\_outra | Verifica se o CPF está vinculado a processos como outras partes. | | nao\_tem\_processos\_reus | Verifica se o CPF/CNPJ está vinculado a processos como réu. | | nao\_tem\_processos\_criminais | Verifica se o CPF/CNPJ está vinculado a processos criminais. | | tem\_author\_type\_nulo\_em\_processos\_criminais | Verifica se há um campo 'authorType' vazio em algum caso criminal. | | {% endtab %} | | | {% endtabs %} | | ## Processos com palavras-chave (PF49) Retorna informações sobre 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 | | -------------------------------------------------- | ---------------- | ----------------------------------------- | | statusCode | String | Consultar status | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.total | Número | Total de processos | | data.foundWords | Array | Palavras-chave encontradas | | data.results | Array | Lista de processos retornados | | 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 | Órgão julgador | | data.results\[x].lawsuitId | String | Número do processo | | data.results\[x].isDigitalLawsuit | Booleano | Se o caso é digital | | data.results\[x].lawBranch | String | Ramo do Direito | | data.results\[x].segment | String | Segmento | | data.results\[x].isJusticeSecret | Booleano | 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 | Retorno do valor do processo | | data.results\[x].lawsuitValue.currency | String | Moeda (R$, U$, etc) | | data.results\[x].lawsuitValue.value | Número | 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 do autor | | {% 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 | | ----------------------------------- | --------------------------------------------------------------------------------------------------- | | tem\_palavras\_chave\_em\_processos | A regra se tornará inválida se alguma das palavras-chave configuradas for encontrada nos processos. | | {% endtab %} | | | {% endtabs %} | | ## KYC e Conformidade (PF17) Esta fonte inclui informações necessárias para atender aos requisitos regulatórios e legais relacionados aos processos de conhecimento do cliente. Ela fornece dados sobre pessoas politicamente expostas (PEPs), sanções e restrições, tanto em nível nacional quanto internacional. O conjunto de dados inclui sinalizadores indicando se um indivíduo é uma PEP ou possui alguma restrição associada, juntamente com registros históricos dessas situações. Se alguém foi uma PEP no passado, o sinalizador não será marcado, mas o registro histórico continuará disponível para análise. lista de bases consultadas: * 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 * EU * FBI * GOVUK * Banco de impedidos de licitar e contratar * INTERPOL * Inidôneos do 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 * UNSC **Seção:** `pfKycCompliance` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- | | statusCode | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/api-core/transaction-details/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 PEP | | data.pepHistory\[x].endDate | String | Data em que a pessoa deixou de ser uma PEP | | 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 ao indivíduo | | data.sanctionsHistory\[x].sanctionName | String | Nome registrado na lista internacional de sanções | | data.sanctionsHistory\[x].nationalities | String | Nacionalidades associadas ao indivíduo | | data.sanctionsHistory\[x].image | String | Foto do indivíduo | | data.sanctionsHistory\[x].height | String | Altura do indivíduo | | 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 | Booleano | Indica se a pessoa atualmente é uma PEP | | data.isCurrentlySanctioned | Booleano | Indica se a pessoa atualmente está sob alguma sanção | | data.last30DaysSanctions | Número | Número de sanções e restrições encontradas nos últimos 30 dias | | data.last90DaysSanctions | Número | Número de sanções e restrições encontradas nos últimos 90 dias | | data.last180DaysSanctions | Número | Número de sanções e restrições encontradas nos últimos 180 dias | | data.last365DaysSanctions | Número | Número de sanções e restrições encontradas nos últimos 365 dias | | data.lastYearPEPOccurence | Número | Número de registros de PEP encontrados no último ano | | data.last3YearsPEPOccurence | Número | Número de registros de PEP encontrados nos últimos 3 anos | | data.last5YearsPEPOccurence | Número | Número de registros de PEP encontrados nos últimos 5 anos | | data.last5PlusYearsPEPOccurence | Número | Número de registros de PEP encontrados nos últimos 5 anos ou mais | | data.firstPEPOccurenceDate | String | Data do primeiro registro de PEP encontrado para o indivíduo | | data.lastPEPOccurenceDate | String | Data do último registro de PEP encontrado para o indivíduo | | data.isCurrentlyElectoralDonor | Booleano | Indica se a pessoa faz doações para campanhas políticas | | data.isHistoricalElectoralDonor | Booleano | Indica se a pessoa já fez doações para campanhas políticas | | data.totalElectoralDonationsLastTwoElections | Número | Número de doações feitas nos dois últimos ciclos eleitorais | | data.totalElectoralDonations | Número | Valor total das doações realizadas | | data.totalElectoralDonationAmountLastTwoElections | Número | Soma do valor doado nos dois últimos ciclos eleitorais | | data.totalElectoralDonationAmount | Número | 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": "SERVIDOR 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": "SERVIDOR 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 | | ----------------- | ----------------------------------------------------------------- | | nao\_tem\_sancoes | Verifique se nenhuma sanção foi encontrada em listas restritivas. | | nao\_tem\_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 PREVIAMENTE SANCIONADO | 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 | | ------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------- | | statusCode | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/api-core/transaction-details/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 e rótulos das entidades 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": { "PESSOAS": { "XXXX XXXXXXX": { "Rótulo": "LIGEIRAMENTE POSITIVO" }, "XXXX XXXXXXX": { "Rótulo": "POSITIVO" } }, "LUGARES": { "BRASIL": { "Rótulo": "LIGEIRAMENTE POSITIVO" }, "AMÉRICA LATINA": { "Rótulo": "LIGEIRAMENTE POSITIVO" } }, "ORGANIZAÇÕES": { "XXXXXXX": { "Rótulo": "POSITIVO" }, "XXXXXXX": { "Rótulo": "LIGEIRAMENTE 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 | | ------------------------------ | ------------------------------------------------------- | | nao\_tem\_exposicao\_na\_midia | Verifica se o titular do CPF possui 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 | | ------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------- | | statusCode | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/api-core/transaction-details/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 | | ----------------------- | --------------------------------------------------------------- | | tem\_processo\_no\_cade | A regra será inválida se houver protocolos processuais no CADE. | | {% endtab %} | | | {% endtabs %} | | ## Lista de sanções da OFAC Pesquise na lista de Nacionais Especialmente Designados e Pessoas Bloqueadas (SDN) do Office of Foreign Assets Control (OFAC). A consulta é feita por nome e é internacional. **Seção:** `pfOfacSanctionsList` **Parâmetro obrigatório:** `nome` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------- | | statusCode | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/api-core/transaction-details/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 | Primeiro 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 validade 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 de sobrenome | | data.sanctionsList\[x].aliases\[x].name | String | Primeiro ou último nome (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 | | ---------------------------------- | ------------------------------------------------------------ | | esta\_na\_lista\_de\_sancoes\_ofac | Verifica se há algum registro na OFAC para o nome informado. | | {% endtab %} | | | {% endtabs %} | | ## Lista privada de restrições (PF78) Consulte 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 | | ---------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- | | statusCode | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/api-core/transaction-details/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descritivo com status da consulta | | data.recordFound | Booleano | Indicação de presença na lista privada de restrições | | 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 | | ---------------------------- | ---------------------------------------------------------------------------- | | esta\_na\_lista\_de\_negados | A regra será inválida se o CPF/CNPJ consultado estiver na Lista de Bloqueio. | | {% endtab %} | | | {% endtabs %} | | ## Pessoas impedidas de apostar - Relação com esportes (PF79) Retorna se o CPF consultado é de 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 | | ---------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------- | | statusCode | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/api-core/transaction-details/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descritivo com status da consulta | | data.sportsRelationshipType | Array | Indica o tipo de relacionamento que a pessoa tem com os esportes | | 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 { "code": "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 | | ----------------------------------- | ---------------------------------------------------- | | e\_pessoa\_relacionada\_ao\_esporte | Verifica se o indivíduo está relacionado a esportes. | | {% endtab %} | | | {% endtabs %} | | ## Pessoas impedidas de apostar - Relação com esportes + 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. Verifica se o CPF informado está associado a outras pessoas, identifica o grau de relacionamento entre elas e fornece outras informações 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 de idade* {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | ---------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | statusCode | String | Status da consulta ([detalhes](/caf-api/caf-api-pt-br/api-core/transaction-details/background-check/data-structure.md#status-code)) | | dados | Objeto | Dados de retorno | | data.message | String | Descritivo com 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 da 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 | 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 (1º NÍVEL INDIRETO, 2º NÍVEL INDIRETO, 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 (ASSISTENTE TÉCNICO, TÉCNICO, MEMBRO DO CONSELHO, DIRETOR, EX-PRESIDENTE, GERENTE, JOGADOR, PRESIDENTE, ÁRBITRO, EQUIPE, VICE-PRESIDENTE) | | data.results\[x].onlineBettingCompliance.sportsExposure.sports\[x].relatedEntities\[x].isActive | Booleano | 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 do relacionamento | | data.results\[x].onlineBettingCompliance.forbiddenBet | Objeto | Dados relacionados a apostas proibidas | | 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 | Booleano | Se a pessoa é do Ministério da Fazenda | | data.results\[x].onlineBettingCompliance.forbiddenBet.isBookmakerOwner | Booleano | Se a pessoa é proprietária de casa de apostas | | data.results\[x].onlineBettingCompliance.forbiddenBet.bookmakerOwnerMotives | Array | Motivos para ser proprietária de 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 de apostas online | | data.status.onlineBettingCompliance\[x].code | Número | 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 | Número | 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 | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | esta\_impedido\_de\_apostar | Verifica se o indivíduo está legalmente impedido de fazer apostas, ou seja, se tem alguma ligação com casas de apostas, o setor esportivo ou o Ministério da Fazenda. | | {% endtab %} | | | {% endtabs %} | | ## Processos judiciais - NOVO (PF52) Retorna todos os processos judiciais disponíveis por meio de uma consulta expandida, garantindo a máxima cobertura de informações. **Seção:** `pfLegalRecordsExtended` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | -------------------------------------------------------------------- | -------- | ------------------------------------------- | | statusCode | String | Consultar status | | dados | Objeto | Dados de retorno | | data.message | String | Descrição do status da consulta | | data.lawsuits | Array | Lista de processos retornados | | data.lawsuits\[x].cnjCode | String | Código CNJ | | data.lawsuits\[x].secrecyLevel | Número | Nível de sigilo | | data.lawsuits\[x].amount | Número | Valor da ação | | data.lawsuits\[x].area | String | Área da ação | | data.lawsuits\[x].instance | Número | Instância 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 | Booleano | Indicação de processo criminal | | data.lawsuits\[x].mainPartySide | String | Lado da parte pesquisada | | data.lawsuits\[x].lastStep | Objeto | Última movimentação do processo | | data.lawsuits\[x].lastStep.stepId | String | Identificador da última movimentação | | data.lawsuits\[x].lastStep.stepDate | String | Data da última movimentação | | data.lawsuits\[x].lastStep.content | String | Conteúdo da última movimentação | | data.lawsuits\[x].lastStep.stepType | String | Tipo da última movimentação | | data.lawsuits\[x].lastStep.stepsCount | Número | Quantidade de etapas da última movimentação | | 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 | Etapas | | data.lawsuits\[x].steps\[x].stepDate | String | Data da etapa | | data.lawsuits\[x].steps\[x].stepType | String | Tipo da etapa | | data.lawsuits\[x].steps\[x].content | String | Conteúdo da etapa | | data.lawsuits\[x].steps\[x].private | String | Etapa sigilosa | | 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 | | ------------------------------------------------- | ------------------------------------------------------------------ | | nao\_tem\_processos | Verifica se o CPF/CNPJ está vinculado a processos. | | nao\_tem\_processos\_parte\_ativa | Verifica se o CPF está vinculado a processos como parte ativa. | | nao\_tem\_processos\_parte\_passiva | Verifica se o CPF está vinculado a processos como parte passiva. | | nao\_tem\_processos\_parte\_outra | Verifica se o CPF está vinculado a processos como outras partes. | | nao\_tem\_processos\_reus | Verifica se o CPF/CNPJ está vinculado a processos como réu. | | nao\_tem\_processos\_criminais | Verifica se o CPF/CNPJ está vinculado a processos criminais. | | tem\_author\_type\_nulo\_em\_processos\_criminais | Verifica se há um campo 'authorType' vazio em algum caso criminal. | | {% endtab %} | | | {% endtabs %} | | ## Processos judiciais com palavras-chave - NOVO (PF53) Retorna todos os processos judiciais disponíveis por meio de uma consulta expandida, garantindo a máxima cobertura de informações. **Seção:** `pfLegalRecordsExtendedKeywords` **Parâmetro obrigatório:** `cpf` {% tabs %} {% tab title="Esquema" %} | Atributo | Tipo | Descrição | | -------------------------------------------------------------------- | -------- | ------------------------------------------- | | statusCode | 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 retornados | | data.lawsuits\[x].matchedWords | Array | Palavras-chave encontradas neste processo | | data.lawsuits\[x].cnjCode | String | Código CNJ | | data.lawsuits\[x].secrecyLevel | Número | Nível de sigilo | | data.lawsuits\[x].amount | Número | Valor da ação | | data.lawsuits\[x].area | String | Área da ação | | data.lawsuits\[x].instance | Número | Instância 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 | Booleano | Indicação de processo criminal | | data.lawsuits\[x].mainPartySide | String | Lado da parte pesquisada | | data.lawsuits\[x].lastStep | Objeto | Última movimentação do processo | | data.lawsuits\[x].lastStep.stepId | String | Identificador da última movimentação | | data.lawsuits\[x].lastStep.stepDate | String | Data da última movimentação | | data.lawsuits\[x].lastStep.content | String | Conteúdo da última movimentação | | data.lawsuits\[x].lastStep.stepType | String | Tipo da última movimentação | | data.lawsuits\[x].lastStep.stepsCount | Número | Quantidade de etapas da última movimentação | | 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 | Etapas | | data.lawsuits\[x].steps\[x].stepDate | String | Data da etapa | | data.lawsuits\[x].steps\[x].stepType | String | Tipo da etapa | | data.lawsuits\[x].steps\[x].content | String | Conteúdo da etapa | | data.lawsuits\[x].steps\[x].private | String | Etapa sigilosa | | 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 | | ----------------------------------- | --------------------------------------------------------------------------------------------------- | | tem\_palavras\_chave\_em\_processos | A regra se tornará 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 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/api-core/transaction-details/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 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.