Skip to main content

Service Consumption

Once the authentication token is generated, one of the following endpoints must be called using the POST method. The token must be sent in the headers as:

Authorization: Bearer **token**

🔗 Available Endpoints

  • Results with risk only::
    POSThttp://localhost:8080/ValidadorDatainnova/ws/ConsultaConsolidadaService/consultaConsolidada/soloRiesgo/true
  • All results:
    POSThttp://localhost:8080/ValidadorDatainnova/ws/ConsultaConsolidadaService/consultaConsolidada/soloRiesgo/false

📦 JSON Structure

{
"tipoDocumento": "cc",
"datoConsultar": "19123402",
"nombre":"PABLO JOSE PEREZ PEREZ",
"codigoPais": "COL"
}
ValorTipoDescripciónRequerido
datoConsultarStringData to queryMandatory
tipoDocumentoStringFormat of the document type to query, refer to the document types guide for more informationMandatory
codigoPaisStringFormat of the country code to query, based on the ISO 3166-1 Alpha-3 format. Refer to the Countries guide for more informationMandatory
nombreStringName or business name of the data to query, note that this field is optional depending on whether it's required for the country and document type. See the document types section for more detailsOptional

You can add optional attributes to customize or enrich the query. We will review these in the next section.

⏱️ Rate Limit

Rate Limit

The service allows a maximum of 4 requests per second. Exceeding this limit will result in a 429 Too Many Requests response.

⌛ Maximum Wait Time

info

The maximum wait time for the service is 420 seconds. If a query exceeds this time, the server will return a 504 Gateway Timeout error.