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"
}
| Valor | Tipo | Descripción | Requerido |
|---|---|---|---|
| datoConsultar | String | Data to query | Mandatory |
| tipoDocumento | String | Format of the document type to query, refer to the document types guide for more information | Mandatory |
| codigoPais | String | Format of the country code to query, based on the ISO 3166-1 Alpha-3 format. Refer to the Countries guide for more information | Mandatory |
| nombre | String | Name 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 details | Optional |
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.