AUTORIZACIONES1 tokenPOST

Consultar autorización

Consulta el estatus vigente de una autorización del titular y la evidencia resguardada del consentimiento. Úsalo para saber si ya puedes disparar la consulta de reporte o score.

Endpoint

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

Parámetros

json

{
  "autorizacion": "aut_9f3k28d1"
}

ParámetroTipoRequeridoDescripción

autorizacionstringSíFolio de la autorización a consultar

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/consultar \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"autorizacion":"aut_9f3k28d1"}'

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": "3c81f5a70b9d24e6c1a8f302",
  "status": "found",
  "autorizacion": "aut_9f3k28d1",
  "estatusAutorizacion": "autorizada",
  "medio": "LIGA",
  "rfc": "HEGM850101AB1",
  "nombres": "MARIA GUADALUPE",
  "primerApellido": "HERNANDEZ",
  "segundoApellido": "GOMEZ",
  "fechaNacimiento": "1985-01-01",
  "fechaCreacion": "2026-09-03T10:24:11Z",
  "fechaAutorizacion": "2026-09-03T10:41:52Z",
  "fechaVencimiento": "2026-09-10T10:24:11Z",
  "consultasRealizadas": 1,
  "evidencia": "https://evidencia.consultasnonstop.com/aut_9f3k28d1.pdf"
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "autorizacion"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

autorizacionstringFolio devuelto al crear la autorización del titular.

Campos de respuesta

CampoTipoDescripción

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

statusstringResultado de la búsqueda del folio de autorización. Ver catálogo Status.

autorizacionstringFolio de la autorización consultada.

messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found.

estatusAutorizacionstringEstatus vigente del consentimiento del titular. Ver catálogo Status de autorización.

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.

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

fechaAutorizacionstring | nullFecha y hora en que el titular otorgó su consentimiento. Es null mientras no ha autorizado.

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

consultasRealizadasnumberNúmero de consultas ya realizadas al amparo de esta autorización.

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.

Status

Valores posibles del campo status.

ValorDescripción

foundSe localizó el folio de autorización. La respuesta incluye sus datos y su estatus.

not_foundEl folio de autorización no fue encontrado. La respuesta incluye el campo message con el detalle.

Status de autorización

Valores posibles del campo estatusAutorizacion.

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.

Medio de autorización

Valores posibles del campo medio.

ValorDescripción

LIGASe envió al titular una liga donde otorga su consentimiento en línea.

NIPSe envió al titular un NIP por SMS que confirma su consentimiento.

FIRMAEl consentimiento se recabó con firma autógrafa o electrónica.

Histórico

Endpoint

GEThttps://api.consultasnonstop.com/v1/autorizaciones/consultar/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": "3c81f5a70b9d24e6c1a8f302",
  "status": "found",
  "autorizacion": "aut_9f3k28d1",
  "estatusAutorizacion": "autorizada",
  "medio": "LIGA",
  "rfc": "HEGM850101AB1",
  "nombres": "MARIA GUADALUPE",
  "primerApellido": "HERNANDEZ",
  "segundoApellido": "GOMEZ",
  "fechaNacimiento": "1985-01-01",
  "fechaCreacion": "2026-09-03T10:24:11Z",
  "fechaAutorizacion": "2026-09-03T10:41:52Z",
  "fechaVencimiento": "2026-09-10T10:24:11Z",
  "consultasRealizadas": 1,
  "evidencia": "https://evidencia.consultasnonstop.com/aut_9f3k28d1.pdf"
}

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/consultar

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/consultar \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"autorizacion":"aut_9f3k28d1"}'

Casos de prueba

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

Casoautorizacion

Caso exitoso — Encontradoaut_9f3k28d1

Caso exitoso — No encontradoaut_0000000000

Sin tokensaut_sintokens1

Error internoaut_errorint01

Unavailable serviceaut_unavail001

Endpoint histórico

GEThttps://sandbox.api.consultasnonstop.com/v1/autorizaciones/consultar/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/consultar/historico/3c81f5a70b9d24e6c1a8f302 \
  -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 3c81f5a70b9d24e6c1a8f302.

Casoid

Caso exitoso3c81f5a70b9d24e6c1a8f302

No encontrado0000000000000000ffffffff

Fuera de rango1111111111111111aaaaaaaa

Error interno2222222222222222bbbbbbbb

Empezar gratis →