API integral de datos de México en tiempo realConsulta de etiquetas e información
POST
/prism/external/queryTagAndInfo-20%0.1 USDT/llamada0.08 USDT/llamadaInstrucciones de facturación gratuita: no se realizará ningún cobro en caso de anomalías.
Facturación de resultados vacíos: la API admite hasta 10 resultados vacíos gratuitos al día.
Definición de resultado vacío: el servidor no encontró datos y devolvió un resultado vacío.
Consulta las etiquetas y la información básica de un ciudadano mediante la CURP, el correo electrónico o el número de teléfono.
Estos ejemplos contienen datos sintéticos completos. Usa tus propios datos autorizados en Online Test para ver la respuesta real de la API.
Empieza a usar este endpoint
- Crea una cuenta o usa la que ya tienes.
- Copia tu token de API en Cuenta → Seguridad.
- Ingresa tu token y los datos que tienes autorización para consultar en Prueba en Línea. Los ejemplos enmascarados solo muestran el formato; debes sustituirlos.
Las pruebas en línea están sujetas a la cuota de pruebas de tu cuenta y a las reglas del gateway. Para llamadas de producción, revisa el precio del endpoint y tu saldo antes de enviar. Ver saldo y recargar
Encabezados
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
X-Api-Token | string | Requerido | Tu token de API de la plataforma |
Parámetros
| Nombre | En | Tipo | Requerido | Ejemplo | Descripción |
|---|---|---|---|---|---|
hello-agent | query | string | Requerido | - | agent |
Ejemplo de Cuerpo de la Solicitud
{
"secretKey": "fb4db743004087af5f63eb98568d284f415df64c9e9ac504770c20dc0845bca1",
"userName": "SAMPLE USER",
"eventCode": "query_tag_info",
"keyword": "TEST900101HDFABC01"
}Respuesta 200JSON
{
"code": 0,
"msg": "OK",
"data": {
"userInfo": {
"TEST900101HDFABC01": {
"ext": {
"risk_accept_score": "45.416",
"job_stable_level": "28",
"credit_level": "1",
"risk_score_3_0": "57.049",
"risk_score_3_1": "39.386",
"repay_level": "3",
"risk_score_1": "65.353",
"salary_level": "27.847",
"apply_loan_level": "7",
"risk_score_2": "21.972",
"status_level": "3"
}
}
},
"tag": {
"TEST900101HDFABC01": [
{
"code": "is_whatsapp"
},
{
"code": "is_advanced_contact"
},
{
"code": "is_night_applicant_old"
},
{
"code": "is_facebook"
},
{
"code": "is_weekend_applicant_new"
},
{
"code": "is_stable_job"
},
{
"code": "is_overdue_30d_order"
},
{
"code": "is_high_salary"
},
{
"code": "is_weekend_applicant_old"
},
{
"code": "is_rejected_applicant"
}
]
}
}
}Campos de Respuesta
| Nombre | Tipo | Significado | Ejemplo | Descripción |
|---|---|---|---|---|
response | JSON | `[ { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel de riesgo de identidad", "field_value_example": "4", "description": "Se calcula a partir del nivel educativo, las cotizaciones a la seguridad social, la situación relacionada con hijos y otras señales. Los valores más altos indican mayor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel salarial", "field_value_example": "11", "description": "Se calcula a partir del salario diario registrado en la seguridad social, el salario registrado en créditos en efectivo y otras señales. Los valores más altos indican menor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel de estabilidad laboral", "field_value_example": "27", "description": "Se calcula a partir de los días trabajados, el número de empleadores que realizan aportaciones a la seguridad social, el tipo de residencia y otras señales. Los valores más altos indican menor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel de capacidad de pago", "field_value_example": "2", "description": "Se calcula a partir del nivel bancario, los depósitos bancarios, el número de instituciones financieras registradas y otras señales. Los valores más altos indican menor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel crediticio", "field_value_example": "0.514", "description": "Se calcula a partir de la tasa histórica de pagos, el importe pagado y el número de órdenes de pago de los últimos 1 a 3 años. Los valores más altos indican menor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel de solicitud de préstamos", "field_value_example": "3", "description": "Se calcula a partir del número de plataformas de préstamos en efectivo registradas, la frecuencia máxima de solicitudes, el número de desembolsos, el número de préstamos recurrentes y otras señales de los últimos 1 a 3 años. Los valores más altos indican mayor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de aceptación del riesgo", "field_value_example": "20.399", "description": "Se calcula a partir del número de plataformas de préstamos en efectivo registradas, las tasas de interés, los plazos de pago, los montos solicitados y otras señales de los últimos 1 a 3 años. Los valores más altos indican un segmento de usuarios de mayor riesgo crediticio y una mayor aceptación del riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de riesgo del usuario V1", "field_value_example": "73.085", "description": "Evalúa el comportamiento posterior al préstamo para productos de un solo periodo y de corto plazo a 7 días. Los valores más altos indican mayor riesgo. Base del modelo: GBDT + LR." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de riesgo del usuario V2", "field_value_example": "27.314", "description": "Evalúa el comportamiento posterior al préstamo para productos a plazos y de mediano plazo de 14 a 30 días. Los valores más altos indican mayor riesgo. Base del modelo: GBDT + LR." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de riesgo del usuario V3, segmento 0", "field_value_example": "58.917", "description": "Evalúa el comportamiento posterior al préstamo para productos a plazos y de mediano a largo plazo de más de 30 días. Los valores más altos indican mayor riesgo. Base del modelo: GBDT + LR." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de riesgo del usuario V3, segmento 1", "field_value_example": "50.396", "description": "Evalúa el comportamiento posterior al préstamo para productos a plazos y de mediano a largo plazo de más de 30 días. Los valores más altos indican mayor riesgo. Base del modelo: GBDT + LR." } ]` | - | `[ { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel de riesgo de identidad", "field_value_example": "4", "description": "Se calcula a partir del nivel educativo, las cotizaciones a la seguridad social, la situación relacionada con hijos y otras señales. Los valores más altos indican mayor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel salarial", "field_value_example": "11", "description": "Se calcula a partir del salario diario registrado en la seguridad social, el salario registrado en créditos en efectivo y otras señales. Los valores más altos indican menor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel de estabilidad laboral", "field_value_example": "27", "description": "Se calcula a partir de los días trabajados, el número de empleadores que realizan aportaciones a la seguridad social, el tipo de residencia y otras señales. Los valores más altos indican menor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel de capacidad de pago", "field_value_example": "2", "description": "Se calcula a partir del nivel bancario, los depósitos bancarios, el número de instituciones financieras registradas y otras señales. Los valores más altos indican menor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel crediticio", "field_value_example": "0.514", "description": "Se calcula a partir de la tasa histórica de pagos, el importe pagado y el número de órdenes de pago de los últimos 1 a 3 años. Los valores más altos indican menor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Nivel de solicitud de préstamos", "field_value_example": "3", "description": "Se calcula a partir del número de plataformas de préstamos en efectivo registradas, la frecuencia máxima de solicitudes, el número de desembolsos, el número de préstamos recurrentes y otras señales de los últimos 1 a 3 años. Los valores más altos indican mayor riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de aceptación del riesgo", "field_value_example": "20.399", "description": "Se calcula a partir del número de plataformas de préstamos en efectivo registradas, las tasas de interés, los plazos de pago, los montos solicitados y otras señales de los últimos 1 a 3 años. Los valores más altos indican un segmento de usuarios de mayor riesgo crediticio y una mayor aceptación del riesgo." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de riesgo del usuario V1", "field_value_example": "73.085", "description": "Evalúa el comportamiento posterior al préstamo para productos de un solo periodo y de corto plazo a 7 días. Los valores más altos indican mayor riesgo. Base del modelo: GBDT + LR." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de riesgo del usuario V2", "field_value_example": "27.314", "description": "Evalúa el comportamiento posterior al préstamo para productos a plazos y de mediano plazo de 14 a 30 días. Los valores más altos indican mayor riesgo. Base del modelo: GBDT + LR." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de riesgo del usuario V3, segmento 0", "field_value_example": "58.917", "description": "Evalúa el comportamiento posterior al préstamo para productos a plazos y de mediano a largo plazo de más de 30 días. Los valores más altos indican mayor riesgo. Base del modelo: GBDT + LR." }, { "name": "SAMPLE USER", "type": "string", "field_description": "Puntuación de riesgo del usuario V3, segmento 1", "field_value_example": "50.396", "description": "Evalúa el comportamiento posterior al préstamo para productos a plazos y de mediano a largo plazo de más de 30 días. Los valores más altos indican mayor riesgo. Base del modelo: GBDT + LR." } ]` |
Origen de los datos
Todavía no se ha confirmado el titular de origen de este endpoint. No te apoyes en él para decisiones sensibles al cumplimiento hasta que se confirme.
Límites y cuota gratuita
- Solicitudes por segundo
- 10
- Resultados vacíos gratis al día
- 10
Las llamadas que no devuelven registro no se cobran, hasta esta cantidad por día. Pasado ese punto, un resultado vacío se cobra al precio unitario.
El saldo se consume al momento de la llamada. Cuando no la cubre, el gateway devuelve 402 y la llamada no se realiza.
Códigos de error
Códigos de estado observados en producción, con cómo atender cada uno. Los códigos no listados no han ocurrido.
| Código | Qué significa y qué hacer |
|---|---|
200 | La petición llegó a la fuente original y se devolvió una respuesta. Incluye el caso “sin registro”, así que revisa la carga y no solo el código. |
402 | El saldo prepagado no cubría la llamada. La llamada no se realizó y no se cobró nada. Recarga y reintenta. |
504 | La fuente original no respondió a tiempo. Reintenta después; es el modo de falla normal de registros lentos. |
404 | La ruta no existe, o el endpoint ya no está publicado. |
401 | Token de API ausente o inválido. |
Condiciones de uso
Este endpoint devuelve datos personales de una persona identificable en poder de un registro o institución nacional. Debes contar con una base legal para cada identificador que consultes, no debes enumerar rangos de identificadores y no debes usar un resultado como base única de una decisión que afecte negativamente a alguien.