AUTORIZACIONES1 tokenPOST

Crear autorización del titular

Genera la autorización con la que el titular consiente la consulta de su historial crediticio conforme a la LRSIC. Devuelve el folio de autorización que necesitas para llamar a cualquier endpoint de reporte o score.

Endpoint

POSThttps://api.consultasnonstop.com/v1/autorizaciones

Parámetros

json

{
  "medio": "LIGA",
  "nombres": "MARIA GUADALUPE",
  "primerApellido": "HERNANDEZ",
  "segundoApellido": "GOMEZ",
  "fechaNacimiento": "1985-01-01",
  "rfc": "HEGM850101AB1",
  "correo": "maria.hernandez@ejemplo.com",
  "telefono": "5512345678"
}

ParámetroTipoRequeridoDescripción

mediostringSíMedio por el que el titular otorga su autorización

nombresstringSíNombres de pila del titular

primerApellidostringSíPrimer apellido del titular

segundoApellidostringNoSegundo apellido del titular

fechaNacimientostringSíFecha de nacimiento del titular en formato ISO YYYY-MM-DD

rfcstringSíRFC del titular con homoclave

correostringNoCorreo electrónico al que se envía la liga de autorización

telefonostringNoTeléfono a 10 dígitos al que se envía el NIP o la liga por SMS

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl

curl -X POST https://api.consultasnonstop.com/v1/autorizaciones \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"medio":"LIGA","nombres":"MARIA GUADALUPE","primerApellido":"HERNANDEZ","segundoApellido":"GOMEZ","fechaNacimiento":"1985-01-01","rfc":"HEGM850101AB1","correo":"maria.hernandez@ejemplo.com","telefono":"5512345678"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON

200 OK

{
  "id": "7a3b912e4d8f1c5a9e27b041",
  "status": "pendiente",
  "autorizacion": "aut_9f3k28d1",
  "medio": "LIGA",
  "rfc": "HEGM850101AB1",
  "nombres": "MARIA GUADALUPE",
  "primerApellido": "HERNANDEZ",
  "segundoApellido": "GOMEZ",
  "fechaNacimiento": "1985-01-01",
  "urlAutorizacion": "https://autoriza.consultasnonstop.com/a/9f3k28d1",
  "fechaCreacion": "2026-09-03T10:24:11Z",
  "fechaVencimiento": "2026-09-10T10:24:11Z",
  "evidencia": null
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "nombres"
  },
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "rfc"
  },
  {
    "type": "catalog",
    "message": "El valor no existe en el catálogo",
    "field": "medio"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

mediostringMedio por el que el titular otorga su consentimiento. Ver catálogo Medio de autorización.

nombresstringNombres de pila del titular tal como aparecen en su identificación oficial.

primerApellidostringPrimer apellido del titular.

segundoApellidostringSegundo apellido del titular. Se omite cuando el titular no tiene segundo apellido.

fechaNacimientostringFecha de nacimiento del titular en formato ISO YYYY-MM-DD.

rfcstringRFC del titular con homoclave (13 caracteres para persona física).

correostringCorreo electrónico al que se envía la liga de autorización. Requerido cuando medio es LIGA.

telefonostringTeléfono a 10 dígitos al que se envía el NIP o la liga por SMS. Requerido cuando medio es NIP.

Campos de respuesta

CampoTipoDescripción

idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.

statusstringEstatus de la autorización al momento de la respuesta. Ver catálogo Status de autorización.

autorizacionstringFolio de la autorización. Es el valor que debes enviar en el campo autorizacion de cualquier consulta de reporte o score.

mediostringMedio por el que se solicitó la autorización. Ver catálogo Medio de autorización.

rfcstringRFC del titular registrado en la autorización.

nombresstringNombres de pila del titular registrados en la autorización.

primerApellidostringPrimer apellido del titular registrado en la autorización.

segundoApellidostringSegundo apellido del titular registrado en la autorización.

fechaNacimientostringFecha de nacimiento del titular en formato ISO YYYY-MM-DD.

urlAutorizacionstring | nullURL que debe abrir el titular para otorgar su consentimiento. Solo está presente cuando medio es LIGA.

fechaCreacionstringFecha y hora de creación de la autorización en formato ISO 8601 UTC.

fechaVencimientostringFecha y hora en que la autorización deja de ser válida para consultar, en formato ISO 8601 UTC.

evidenciastring | nullURL de la evidencia resguardada del consentimiento. Es null mientras el titular no ha autorizado.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Medio de autorización

Valores posibles del campo medio.

ValorDescripción

LIGASe envía al titular una liga donde otorga su consentimiento en línea. Requiere el campo correo.

NIPSe envía al titular un NIP por SMS que confirma su consentimiento. Requiere el campo telefono.

FIRMAEl consentimiento se recaba con firma autógrafa o electrónica y se carga como evidencia.

Status de autorización

Valores posibles del campo status.

ValorDescripción

pendienteLa autorización fue generada y está en espera de que el titular la otorgue.

autorizadaEl titular otorgó su consentimiento. El folio ya puede usarse para consultar.

rechazadaEl titular rechazó otorgar su consentimiento. El folio no puede usarse.

expiradaLa autorización venció sin que el titular la otorgara. Genera una nueva.

Histórico

Endpoint

GEThttps://api.consultasnonstop.com/v1/autorizaciones/historico/{id}

El {id} corresponde al campo id devuelto en la respuesta de la consulta principal.

Si necesitas la lista completa de elementos almacenados, accede a tu dashboard.

La respuesta está sujeta al tiempo de almacenamiento de tu plan. Si requieres más tiempo, cambia de plan en tu dashboard.

Respuesta

JSON

200 OK

{
  "id": "7a3b912e4d8f1c5a9e27b041",
  "status": "pendiente",
  "autorizacion": "aut_9f3k28d1",
  "medio": "LIGA",
  "rfc": "HEGM850101AB1",
  "nombres": "MARIA GUADALUPE",
  "primerApellido": "HERNANDEZ",
  "segundoApellido": "GOMEZ",
  "fechaNacimiento": "1985-01-01",
  "urlAutorizacion": "https://autoriza.consultasnonstop.com/a/9f3k28d1",
  "fechaCreacion": "2026-09-03T10:24:11Z",
  "fechaVencimiento": "2026-09-10T10:24:11Z",
  "evidencia": null
}

Respuestas en error

JSON

404 Not Found

[
  {
    "type": "not_found",
    "message": "el id no fue encontrado en el historico"
  }
]

Sandbox

Endpoint

POSThttps://sandbox.api.consultasnonstop.com/v1/autorizaciones

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl -X POST https://sandbox.api.consultasnonstop.com/v1/autorizaciones \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"medio":"LIGA","nombres":"MARIA GUADALUPE","primerApellido":"HERNANDEZ","segundoApellido":"GOMEZ","fechaNacimiento":"1985-01-01","rfc":"HEGM850101AB1","correo":"maria.hernandez@ejemplo.com","telefono":"5512345678"}'

Casos de prueba

Si envías un valor de RFC que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de HEGM850101AB1.

CasoRFC

Caso exitoso — PendienteHEGM850101AB1

Caso exitoso — AutorizadaAUTA800101AB2

Caso exitoso — RechazadaRECB750202CD3

Sin tokensSINC700303EF4

Error internoERRD650404GH5

Unavailable serviceUNAE600505IJ6

Endpoint histórico

GEThttps://sandbox.api.consultasnonstop.com/v1/autorizaciones/historico/{id}

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl https://sandbox.api.consultasnonstop.com/v1/autorizaciones/historico/7a3b912e4d8f1c5a9e27b041 \
  -H "x-api-key: tu_api_key_sandbox"

Casos de prueba histórico

Si envías un valor de id que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de 7a3b912e4d8f1c5a9e27b041.

Casoid

Caso exitoso7a3b912e4d8f1c5a9e27b041

No encontrado0000000000000000ffffffff

Fuera de rango1111111111111111aaaaaaaa

Error interno2222222222222222bbbbbbbb

Empezar gratis →