Pular para o conteúdo principal

Consultar validação de verificação de antecedentes

GET/validate/backgroundchave públicapuk_

Serviço para consultar uma validação de verificação de antecedentes.

Autenticação​

Inclua sua chave pública no cabeçalho Authorization.

Authorization: puk_xxx...

Parâmetros de consulta​

NomeDescrição
code
String		Obrigatório.
Código do processo a consultar.

🧪 Exemplos de uso​

curl -X GET '{{api_auco}}/validate/background?code=XXXXXXXXX' \
  -H 'Authorization: {{public_key}}'

📥 Exemplos de resposta​

info

A propriedade ready indica se o processo de validação foi concluído ou se o documento ainda não está pronto. Se o documento estiver pronto, a propriedade url conterá a URL assinada para baixar o documento. As URLs assinadas são válidas por 5 minutos antes de expirar.

{
  "code": "XXXXXXXXX",
  "name": "1001001010",
  "email": "example@auco.ai",
  "data": {
    "name": "NOMBRE APELLIDO APELLIDO",
    "type": "CC",
    "identification": "1001001010",
    "expeditionDate": "01/01/1995"
  },
  "ready": false
}

Campos da resposta​

CampoTipoDescrição
codeStringCódigo único do processo de validação.
nameStringNúmero de identificação consultado.
emailStringEndereço de e-mail associado ao processo.
urlStringURL assinada para baixar o relatório em PDF. Presente apenas quando ready: true. Expira em 5 minutos.
readyBooleanIndica se a validação foi concluída.
dataObjectDados básicos da pessoa consultada.
data.nameStringNome completo da pessoa.
data.typeStringTipo de documento (ex.: CC, CE, PA).
data.identificationStringNúmero de identificação.
data.expeditionDateStringData de expedição do documento.
data.errorBooleanIndica se houve erro em alguma das fontes de consulta.
data.reportsBooleanIndica se foram encontrados registros negativos.
validationObjectResultados detalhados da validação de antecedentes. Presente apenas quando ready: true.

Campos do objeto validation​

CampoTipoDescrição
contaduriaBooleanResultado da consulta à Contaduría General de la Nación (Contadoria Geral).
contraloriaBooleanResultado da consulta à Contraloría General de la República (Controladoria Geral).
defuncionObjectInformações sobre o status de óbito. Inclui date, doc e validity.
delitos_sexualesArrayRegistros encontrados na base de dados de crimes sexuais.
hallazgosObjectAchados classificados por nível de risco.
hallazgos.altosArrayAchados de risco alto.
hallazgos.mediosArrayAchados de risco médio.
hallazgos.bajosArrayAchados de risco baixo.
hallazgos.infosArrayAchados informativos (RUT, FOSYGA, RUAF, SISBEN, SENA etc.). Não representam risco.
nivelStringNível de risco geral: alto, medio, bajo ou info (sem achados de risco).
interpolBooleanResultado da consulta à lista de procurados da Interpol.
ofacBooleanResultado da consulta à lista de sanções da OFAC.
policiaBooleanResultado da consulta de antecedentes policiais.
proveedores_ficticiosBooleanResultado da consulta à lista de fornecedores fictícios da DIAN.
ramaObjectResultados das consultas a varas judiciais (JEPMS) por cidade. Cada chave é um booleano.
rama_unificadaArrayResultados de processos judiciais da Rama Judicial unificada.
registraduriaObjectInformações da Registraduría Nacional (registro civil). Inclui cedula, estado, fecha_exp, lugar_exp e nombre.
ruesObject | BooleanInformações do Registro Único Empresarial e Social (RUES). false se não estiver registrado.
rutStringNúmero do Registro Único Tributário (RUT).
rut_estadoStringStatus do RUT (ex.: REGISTRO ACTIVO).
nombreStringNome completo do titular segundo a fonte consultada.
generoStringGênero informado (M / F).
tipo_documentoStringTipo de documento (ex.: CC, CE, PA).
fechaStringData e hora de geração do relatório.
errorBooleanIndica se alguma fonte consultada retornou erro. Detalhes em errores.
erroresArray<String>Lista de fontes que falharam durante a consulta (ex.: ["monteriajepms", "cartagenajepms"]).
fosygaObjectInformações de afiliação à EPS da BDUA (FOSYGA). Inclui entidad, estado, regimen, tipo_afiliado, fecha_afiliacion, fecha_finalizacion_afiliacion, departamento, municipio, entre outros.
lista_onuBooleanCorrespondência na lista consolidada de sanções das Nações Unidas.
lista_banco_mundialObjectResultados do Banco Mundial. Inclui debarred_firms_individuals e others_sanctions.
offshoreleaksObjectCorrespondências em Offshore Leaks. Contém Panama Papers, Pandora Papers, Paradise Papers, Bahamas Leaks e Offshore Leaks.
europolArrayCorrespondências nas listas da Europol.
iadbArrayCorrespondências na lista do Banco Interamericano de Desenvolvimento.
cidobObjectCorrespondências na base de dados do CIDOB (biografias de líderes políticos).
ofac_nombreBooleanCorrespondência na OFAC por nome.
ofac_resultadosBoolean | ArrayResultados adicionais da OFAC.
pepsArrayCorrespondências em listas de PEP (Pessoas Politicamente Expostas).
peps_denomArrayCorrespondências de PEP por denominação.
procuraduriaArrayRegistros da Procuraduría General de la Nación (Procuradoria-Geral).
sigepObjectInformações do Sistema de Informação e Gestão do Emprego Público.
sirnaArrayCorrespondências no Sistema de Informação do Registro Nacional de Advogados.
paco_onlineArrayResultados do Portal Anticorrupção da Colômbia (PACO).
inpecObjectInformações do Instituto Nacional Penitenciário e Carcerário.
insolvenciasArrayProcessos de insolvência registrados.
juzgados_tybaArrayProcessos judiciais no sistema Tyba.
reputacionalObjectInformações reputacionais. Contém news (notícias com title, link, sentimiento), social (redes sociais) e notable.
relacionadosArrayPessoas relacionadas ao titular do documento.
ruafObjectRegistro Único de Afiliados. Inclui afiliações a Salud, Pensiones, ARL, Cesantías, Caja de compensación, Pensionado, Programas de Asistencia Social e Basico (dados básicos).
sisbenObjectClassificação do SISBEN. Inclui Grupo, Tipo de grupo, Departamento, Municipio, Estado e Actualizacion Ciudadano.
senaArrayCursos e certificados do SENA. Cada elemento inclui Programa, Tipo, Certificación, Registro e Descarga.
simitObjectInformações do SIMIT (multas de trânsito). Inclui paz_salvo, cantidad_multas, multas, acuerdos_pagos, total_pagar e cursos.
runtObjectInformações do RUNT. Inclui licencia (carteiras de motorista) e multa.
simurArrayMultas do Sistema Integrado de Mobilidade de Bogotá (SIMUR).
rndcArrayRegistro Nacional de Motoristas de Carga.
rnmcObjectRegistro Nacional de Medidas Corretivas (Polícia Nacional).
profesionObjectRegistros profissionais. Inclui abogado, abogados_judicial, rethus, copnia, jcc, comvezcol, consejopro, cpae, cpbiol, cpiq, cpnt, cpqcol, conalpe, conaltel, colpsic, anec.
secopArrayContratos públicos do SECOP I.
secop2ArrayContratos públicos do SECOP II.
secop_proveedoresArrayInformações de fornecedores no SECOP.
garantias_mobiliariasArrayGarantias mobiliárias registradas em nome do titular.
libreta_militarObjectInformações da caderneta militar.
contadoresArrayInformações do registro de contadores públicos.
fopepObjectFundo de Pensões Públicas (aposentados do regime público).
personeria_bogotaArrayRegistros da Personería (ouvidoria) de Bogotá.
sisconmpObjectSistema de Inabilitações por Maus-Tratos e Perda do Poder Familiar.

Estrutura de um achado​

Cada elemento em hallazgos.altos, hallazgos.medios, hallazgos.bajos e hallazgos.infos tem a seguinte estrutura:

CampoTipoDescrição
cantidadStringNúmero de correspondências encontradas.
codigoStringCódigo identificador do tipo de achado.
coincidenciaStringIndica se houve correspondência ("True" / "False").
descripcionStringDescrição detalhada do achado.
fuenteStringFonte da informação.
hallazgoStringResumo do achado.
html_idString | nullURL para baixar o detalhe do achado, se aplicável.

⚠️ Respostas de erro​

CódigoDescrição
400Parâmetro code ausente.
Processo não encontrado VALIDATION_NOT_FOUND.
401Autenticação inválida ou ausente.