ReconoSER ID
Documentation Powered by ReDoc

Consulta de fuentes abiertas (API) (3.0.0)

Download OpenAPI specification:Download

Contacto de Soporte: gestion@reconoserid.com URL: https://reconoserid.com/ License: Reconoser ID Datahub License Terms of Service

Consulta de fuentes abiertas (API) 3.0. Data search, risk analysis and data sources integration via RestAPI services.

Introducción y funcionamiento general

Esta API permite consultas diferentes listas y fuentes abiertas de información. Se diferencia entre robots y listas. Los robots son ejecuciones de RPA (Robotic Process Automation) a fuentes externas y el èxito/velocidad de la consulta depende de la disponibilidad de la fuente que esta siendo consultada (en ningun caso supera los 5min). Las listas por el contrario son consultas a fuentes internas y su indice de exito es del 100% con tiempos de respuesta alrededor de ~2seg. Cada request por lo tanto es una solicitud de consulta a una o multiples robots/listas.

Introduction and general operation

This API allows queries from different lists and open sources of information. It differs between "robots" and "lists". The robots are RPA (Robotic Process Automation) executions to external sources, and the success/speed of the consultation depends on the availability of the source (in no case exceeds 5min). The lists, on the other hand, are queries to internal sources and their success rate is very high in relative fast response times (~ 2sec). Each request is, therefore, a query request to one or multiple robots/lists.

Principal endpoints

El endpoint principal de consulta /robotrequest recibe la consulta y genera una respuesta inmediata del estado de la misma con un identificador único de la petición denominado query_token que se encuentra en el objeto QUERYTOKEN dentro del MainResponse schema. Con dicho query token se puede consultar de forma periodica el estado del request al endpoint ​/robotdetails. Como politica de uso responsable se puede hacer peticiones máximo cada 3seg utilizando un mismo query_token.

Main endpoints

The main query endpoint "/robotrequest" receives the query and generates an immediate response of the status with a unique request identifier called "query_token" found in the QUERYTOKEN object within the MainResponse schema. With this query token, you can periodically check the status of the request to the endpoint "/robotdetails". As a responsible use policy, requests can be made every 3sec using the same query_token.

Requerimientos de parametros por robot/lista solicitada

Cada robot/lista requiere de unos parámetros mínimos de entrada, generando un response 400 en caso de que no se cumplan. A continuación se listan los requerimientos de cada robot/lista:

Parameter requirements per robot/list

Each robot/list requires minimum input parameters. The requirements of each robot/list (parameters required in []) are listed below.

Recuperación de evidencias

Como elemento validatorio de la consulta generamos screenshots/pdf de la respuesta de las fuentes consultadas. Para los robots (type: ROBOT) que no presentan errores (status: NO ERRORS) se pueden acceder a estas evidencias a traves de https://52.71.184.1/v3.0/static/screenshots/FILENAME. Para cada robot los siguientes patrones de QUERYTOKEN son usados como FILENAME:

Evidence recovery

As a query validation element, we generate screenshots/pdf of the response from the consulted sources. For robots (type: ROBOT) that do not present errors (status: NO ERRORS), the evidence can be accessed through https://52.71.184.1/v3.0/static/screenshots/FILENAME. For each robot the following pattern is used for FILENAME:

  • POLI: policia_QUERYTOKEN.png
  • PROCU: procuraduria_QUERYTOKEN.png
  • TYBA: tyba_QUERYTOKEN.png
  • CONTRAL: contral_QUERYTOKEN.pdf
  • SISBEN: sisben_QUERYTOKEN.png
  • JEPM: jepmbog_QUERYTOKEN.png, jepmmed_QUERYTOKEN.png, jepmcal_QUERYTOKEN.png
  • LVREGI: lvregi_QUERYTOKEN.png
  • CURPRFC: curprfc_QUERYTOKEN.png
  • CEDEXT: cedext_QUERYTOKEN.png
  • INFRAMEX: inframex_QUERYTOKEN.png
  • PEPM: pepm_QUERYTOKEN.png
  • ECONJUDI: econjudi_QUERYTOKEN.png
  • REGISECU: regisecu_QUERYTOKEN.png
  • ADRES: adres_QUERYTOKEN.png
  • ANTEECU: anteecu_QUERYTOKEN.pdf
  • RENAPO: renapo_QUERYTOKEN.png
  • RENAPO2: renapo2_QUERYTOKEN.png
  • RUES: rues_QUERYTOKEN.png
  • RUAF: ruaf_QUERYTOKEN.png
  • INTERPOL: interpol_QUERYTOKEN.png
  • SIGEP: sigep_QUERYTOKEN.png
  • RNMC: rnmc_QUERYTOKEN.png
  • RUNT: runt_QUERYTOKEN.png
  • RUNTP: runtp_QUERYTOKEN.png

Las evidencias son almacenadas por 8 días.The evidences are stored for 8 days.

Autorización de tratamiento de datos personales

Cada persona o entidad consultada por el API debe aceptar nuestra autorización de tratamiento de datos personales ATDP.

Authorization for the management of personal data

Each person or entity consulted using this API must accept our authorization to process personal data ATDP.

Authentication

ApiKeyAuth

Security Scheme Type API Key
Query parameter name: account_token

New request

Receive and process a new request (all requests must go through this endpoint).

Authorizations:
ApiKeyAuth
query Parameters
tipo_doc
string
Enum: "cedula" "cedula_extranjeria" "pasaporte" "mx_curp" "ec_cedula" "ar_dni" "nit" "pep"

Document identification type. 'cedula' - Colombian identificaction document, 'cedula_extranjeria' - Colombian immingration document, 'pasaporte' - Passport, 'mx_curp' - Mexican identification CURP, 'ec_cedula' - Ecuadorian document, 'ar_dni' - Argentine document, 'nit' - Colombian tax identification number, 'pep' - Colombian special stay permit

documento
string

Identification card number. It is required only for the execution of certain robots. Do not use periods or hyphens. For NIT type documents do not use the verification digit.

names
string

Name of the searched person

lastnames
string

Lastname of the searched person

robot
Array of strings
Items Enum: "POLI" "PROCU" "TYBA" "GOOGLE" "LINKEDIN" "CONTRAL" "SISBEN" "JEPMS" "LVREGI" "LVREGI2" "CURPRFC" "INFRAMEX" "CEDEXT" "PEPM" "ECONJUDI" "REGISECU" "ADRES" "ANTEECU" "RENAPO" "RENAPO2" "RUES" "RUES2" "RUES3" "RUAF" "INTERPOL" "SIGEP" "RNMC" "RUNT" "RUNTP" "RUNT2" "RUNTP2"

Robot(s) to be executed. Note: This is a multiple value param. 'POLI': 'Antecedentes Policía Colombia','PROCU': 'Antecedentes Procuraduría Colombia','TYBA': 'Consulta de Procesos Judiciales TYBA - Colombia','CONTRAL' : 'Consulta Certificado Antecedentes Fiscales Colombia', 'SISBEN': 'Consulta puntaje SISBEN Colombia','JEPM': 'Juzgados de ejecución de penas y medidas de seguridad Colombia','CURPRFC': 'Consulta RFC Mexico','INFRAMEX': 'Infracciones de transito México','CEDEXT': 'Certificación del estado de Cédula de Extranjería Colombia','PEPM': 'Certificación del Permiso Especial de Permanencia Colombia','ECONJUDI': 'Consejo de la Judicatura de Ecuador','REGISECU': 'Verificacón de cédula de Ecuador','ADRES': 'Consulta afiliados compensados','ANTEECU' 'Antecedentes Ecuador','RENAPO': 'Consulta CURP Mexico','RUES': 'Consulta Rues Colombia','RUAF': 'Registro Único de Afiliados Colombia','INTERPOL': 'Lista roja de Interpol (Múltiples paises)','SIGEP': 'Directorio de Servidores Públicos Colombia', 'RNMC': 'Sistema Registro Nacional de Medidas Correctivas Colombia', 'RUNT': 'Consulta de Vehiculo Registro Único Nacional de Tránsito Colombia', 'RUNTP': 'Consulta de Persona Registro Único Nacional de Tránsito Colombia'

list
Array of strings
Items Enum: "SDN" "HIBP" "ONU" "WORLDBANK" "BIS" "IPSCAM" "CLFSUK" "UETERR" "SUPERSO"

Set of lists PEPs/LA to be searched. Note: This is a multiple value param. 'SDN':'Specially Designated Nationals And Blocked Persons List (Lista Clinton)', 'HIBP' : 'Haveibeenpwned service', 'WORLDBANK':'Procurement - World Bank Listing of Ineligible Firms and Individuals','BIS':'Bureau of Industry and Security U.S Department of Commerce Denied Persons List', 'IPSCAM': 'Ip security breaches', 'UETERR': 'EU terrorist list', 'SUPERSO': 'Superintendencia de Sociedades, companies basic data 2018', 'CLFSUK': 'Consolidated List of Financial Sanctions Targets in the UK'.

fecha_expe_doc
string

Document identification issue date (YYYY-MM-DD)

fecha_nacimiento
string

Birth date (YYYY-MM-DD)

ip
string

IP address. Only for IPSCAM list.

email
string

Email address. Only for HIBP list.

Responses

Response samples

Content type
application/json
application/json
application/xml
{
  • "data":
    {
    },
  • "status": "Robots in execution process"
}

The updated details of a request are consulted on this endpoint. It can be consulted maximum every three seconds.

Authorizations:
ApiKeyAuth
query Parameters
query_token
required
string

Query token. Note 'query_token' is the token returned by the request

Responses

Response samples

Content type
application/json
application/json
application/xml
{
  • "data":
    {
    },
  • "status": "Robots in execution process"
}

Token status

Return all information about a particular token

query Parameters
token_query
required
string

Token to be searched

Responses