Acompanhar um dossiê

Devolve o estado do dossiê (pending, completed ou failed) e, quando concluído, o resultado completo. Só a conta que criou o dossiê consegue ler.

Parâmetros

idstringobrigatório

No caminho. O dossie_id devolvido pelo POST /v1/dossie/cpf.

Gratuito. A cobrança de 100 créditos acontece uma única vez, quando o dossiê é concluído.

• Enquanto o status é pending, a resposta traz apenas o andamento. Depois de concluído, o resultado fica guardado na sua conta e pode ser consultado a qualquer momento, sem novo custo.
• Dossiê inexistente ou de outra conta responde 404 com o código DOSSIER_NOT_FOUND.
• Os valores de risk_level: HIGH (sancionado no CEIS, CNEP ou em lista internacional, expulso da administração federal, licitante inidôneo no TCU ou no cadastro de trabalho escravo), MEDIUM (PEP, dívida ativa a partir de R$ 50.000, inabilitado para função pública, contas julgadas irregulares ou com implicação eleitoral no TCU) e LOW (demais casos).

Campos do resultado

data.statusstring

pending, completed ou failed.

data.completed_atstring

Quando o dossiê terminou. Ausente enquanto pending.

data.basic_infoobject

Dados cadastrais do titular.

data.basic_info.full_namestring

Nome do titular.

data.basic_info.cadastral_statusstring | null

Situação cadastral na Receita Federal (ex.: REGULAR).

data.basic_info.birth_datestring

Data de nascimento, AAAA-MM-DD.

data.compliance_summary.has_sanctionsboolean

true se houver registro no CEIS, no CNEP, no CEAF, em lista de sanções internacional ou como licitante inidôneo no TCU.

data.compliance_summary.is_pepboolean

true se a pessoa for politicamente exposta.

data.compliance_summary.has_active_debtsboolean

true se houver dívida ativa da União (PGFN).

data.compliance_summary.has_possible_matchesboolean

true se alguma fonte devolveu POSSIBLE_MATCH (busca só por nome, pode ser um homônimo). Pede conferência e leva o risco a, no mínimo, MEDIUM.

data.compliance_summary.risk_levelstring

LOW, MEDIUM ou HIGH.

data.details.*.statusstring

Resultado de cada fonte: CLEAR (nada consta), MATCH (consta, encontrado pelo CPF), POSSIBLE_MATCH (possível correspondência: a busca foi só por nome e pode ser um homônimo, confira antes de decidir), NOT_APPLICABLE (faltou um dado necessário, como o nome do titular) e UNAVAILABLE (a fonte falhou depois das tentativas; o dossiê então falha e não é cobrado). Só MATCH eleva o risco a HIGH; POSSIBLE_MATCH eleva no máximo a MEDIUM.

data.details.pepobject

is_pep e a fonte (CGU).

data.details.ceisobject

found: há registro no CEIS.

data.details.slave_laborobject

found: consta no Cadastro de Empregadores do MTE (trabalho análogo ao de escravo). matches traz, para cada entrada, match (cpf: CPF do empregador igual ao consultado; name: empresário individual com o mesmo nome, indício), state, fiscal_action_year, workers_involved, decision_date e inclusion_date. data_base é a data da publicação da lista (semestral).

data.details.pgfn_active_debtobject

found, total_amount (R$), records_count e data_base (data da base da PGFN) da dívida ativa. O cruzamento é por 6 dígitos do CPF e nome: é um indício.

data.details.international_sanctionsobject

Listas de sanções da OFAC (EUA), ONU e União Europeia. found, data_base e matches (source, matched_name, program, citizenship). As listas não têm CPF: o cruzamento é pelo nome completo exato e vale como indício, confira antes de concluir.

data.details.cnepobject

found: há registro no CNEP (Cadastro Nacional de Empresas Punidas), pelo CPF completo.

data.details.ceafobject

found: consta no CEAF (Cadastro de Expulsões da Administração Federal). O Portal da Transparência publica o CPF parcialmente oculto, então o cruzamento usa os dígitos visíveis e o nome completo e vale como indício. matches traz punishment, published_at e agency.

data.details.tcuobject

Listas do Tribunal de Contas da União, todas pelo CPF: unfit_bidder (licitantes inidôneos), disqualified (inabilitados para função pública), irregular_accounts (contas julgadas irregulares) e electoral (contas irregulares com possível implicação eleitoral). Cada uma tem found e, quando consta, matches com process, decision, final_judgment_date, end_date e uf.

data.errorobject

Só quando failed: code (SOURCE_UNAVAILABLE ou CPF_NOT_FOUND) e message. Nada é cobrado.