← Catálogo
CÍRCULO8 tokensPOST

Reporte de crédito de Persona Física

Consulta el reporte de crédito completo de una persona física en Círculo de Crédito, con la autorización del titular. Devuelve score, resumen del historial y el detalle de cada cuenta en campos legibles — sin tramas de ancho fijo ni claves que requieran manual.

Endpoint

POSThttps://api.consultasnonstop.com/v1/circulo/reporte-pf

Parámetros

json
{
  "autorizacion": "aut_9f3k28d1",
  "nombres": "MARIA GUADALUPE",
  "primerApellido": "HERNANDEZ",
  "segundoApellido": "GOMEZ",
  "fechaNacimiento": "1985-01-01",
  "rfc": "HEGM850101AB1",
  "codigoPostal": "06700",
  "moneda": "MXN"
}
ParámetroTipoRequeridoDescripción
autorizacionstringSíFolio de la autorización del titular
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
rfcstringNoRFC del titular con homoclave
codigoPostalstringSíCódigo postal del domicilio del titular a 5 dígitos
monedastringNoMoneda en la que se expresan los importes del reporte. Por defecto MXN

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/circulo/reporte-pf \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"autorizacion":"aut_9f3k28d1","nombres":"MARIA GUADALUPE","primerApellido":"HERNANDEZ","segundoApellido":"GOMEZ","fechaNacimiento":"1985-01-01","rfc":"HEGM850101AB1","codigoPostal":"06700","moneda":"MXN"}'

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": "c72a5f18d94b60e3a1c852f7",
  "status": "found",
  "autorizacion": "aut_9f3k28d1",
  "folioConsulta": "CNS-2026-0004815",
  "fechaConsulta": "2026-09-03",
  "rfc": "HEGM850101AB1",
  "nombres": "MARIA GUADALUPE",
  "primerApellido": "HERNANDEZ",
  "segundoApellido": "GOMEZ",
  "fechaNacimiento": "1985-01-01",
  "codigoPostal": "06700",
  "moneda": "MXN",
  "score": 743,
  "codigosRazon": ["A05", "B12", "C03"],
  "totalCuentas": 12,
  "cuentasAbiertas": 7,
  "cuentasCerradas": 5,
  "atrasosVigentes": 0,
  "peorAtrasoHistorico": 2,
  "saldoActualTotal": 184500,
  "creditoMaximoTotal": 320000,
  "pagoMensualTotal": 9800,
  "antiguedadHistorialMeses": 96,
  "consultasUltimos12Meses": 3,
  "cuentas": [
    {
      "otorgante": "BANCO EJEMPLO",
      "tipoContrato": "REVOLVENTE",
      "tipoCuenta": "TARJETA DE CREDITO",
      "numeroCuenta": "****4821",
      "fechaApertura": "2019-03-14",
      "fechaUltimoPago": "2026-08-28",
      "creditoMaximo": 80000,
      "saldoActual": 42300,
      "saldoVencido": 0,
      "pagoMensual": 3500,
      "claveMop": "01",
      "estatusCuenta": "AL CORRIENTE",
      "historicoPagos": "111111111111"
    },
    {
      "otorgante": "FINANCIERA EJEMPLO",
      "tipoContrato": "PAGOS FIJOS",
      "tipoCuenta": "CREDITO AUTOMOTRIZ",
      "numeroCuenta": "****9037",
      "fechaApertura": "2023-07-01",
      "fechaUltimoPago": "2026-08-15",
      "creditoMaximo": 240000,
      "saldoActual": 142200,
      "saldoVencido": 0,
      "pagoMensual": 6300,
      "claveMop": "01",
      "estatusCuenta": "AL CORRIENTE",
      "historicoPagos": "111111112111"
    }
  ]
}

Respuestas en error

JSON
400 Bad Request
[
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "autorizacion"
  },
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "codigoPostal"
  },
  {
    "type": "catalog",
    "message": "El valor no existe en el catálogo",
    "field": "moneda"
  }
]

Campos

Campos de entrada

CampoTipoDescripción
autorizacionstringFolio de la autorización otorgada por el titular. Debe estar en estatus autorizada y vigente.
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. Mejora la precisión del match en la fuente.
codigoPostalstringCódigo postal del domicilio del titular a 5 dígitos.
monedastringMoneda en la que se expresan los importes del reporte. Ver catálogo Moneda.

Campos de respuesta

CampoTipoDescripción
idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.
statusstringResultado de la consulta del historial en la fuente. Ver catálogo Status.
messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found. Ver catálogo Mensajes not_found.
autorizacionstringFolio de la autorización al amparo de la cual se realizó la consulta.
folioConsultastringFolio de la consulta ante la fuente, para efectos de auditoría.
fechaConsultastringFecha en que se realizó la consulta en formato ISO YYYY-MM-DD.
rfcstringRFC del titular consultado.
nombresstringNombres de pila del titular según la fuente.
primerApellidostringPrimer apellido del titular según la fuente.
segundoApellidostringSegundo apellido del titular según la fuente.
fechaNacimientostringFecha de nacimiento del titular en formato ISO YYYY-MM-DD.
codigoPostalstringCódigo postal del domicilio registrado en la fuente.
monedastringMoneda en la que se expresan los importes del reporte. Ver catálogo Moneda.
scorenumberScore crediticio del titular. Va de 300 a 850: a mayor valor, menor riesgo.
codigosRazonarrayCódigos que explican los factores que más pesaron en el score, ordenados por impacto.
totalCuentasnumberNúmero total de cuentas de crédito reportadas, abiertas y cerradas.
cuentasAbiertasnumberNúmero de cuentas de crédito vigentes.
cuentasCerradasnumberNúmero de cuentas de crédito ya cerradas o liquidadas.
atrasosVigentesnumberNúmero de cuentas con pagos vencidos al momento de la consulta.
peorAtrasoHistoriconumberPeor nivel de atraso registrado en el historial, expresado en clave MOP numérica.
saldoActualTotalnumberSuma de los saldos actuales de todas las cuentas abiertas.
creditoMaximoTotalnumberSuma de las líneas de crédito otorgadas en todas las cuentas abiertas.
pagoMensualTotalnumberSuma de los pagos mensuales exigibles de todas las cuentas abiertas.
antiguedadHistorialMesesnumberMeses transcurridos desde la apertura de la cuenta más antigua.
consultasUltimos12MesesnumberNúmero de consultas al historial del titular realizadas por otorgantes en los últimos 12 meses.
cuentasarrayDetalle de cada cuenta de crédito reportada por los otorgantes.
cuentas[].otorgantestringNombre de la institución que reporta la cuenta.
cuentas[].tipoContratostringForma en que se pacta el pago del crédito. Ver catálogo Tipo de contrato.
cuentas[].tipoCuentastringProducto crediticio al que corresponde la cuenta.
cuentas[].numeroCuentastringNúmero de cuenta enmascarado, solo con los últimos cuatro dígitos visibles.
cuentas[].fechaAperturastringFecha de apertura de la cuenta en formato ISO YYYY-MM-DD.
cuentas[].fechaUltimoPagostring | nullFecha del último pago registrado en formato ISO YYYY-MM-DD.
cuentas[].creditoMaximonumberLínea de crédito autorizada o monto original del crédito.
cuentas[].saldoActualnumberSaldo insoluto de la cuenta al corte reportado.
cuentas[].saldoVencidonumberMonto vencido y no pagado al corte reportado.
cuentas[].pagoMensualnumberPago mensual exigible de la cuenta.
cuentas[].claveMopstringClave que resume el comportamiento de pago de la cuenta. Ver catálogo Clave MOP.
cuentas[].estatusCuentastringEstatus de la cuenta al momento de la consulta. Ver catálogo Estatus de cuenta.
cuentas[].historicoPagosstringCadena de 12 claves MOP, una por mes, de la más reciente a la más antigua.

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 historial crediticio del titular. La respuesta incluye el reporte completo.
not_foundLa fuente no tiene historial crediticio del titular. La respuesta incluye el campo message con el detalle.

Mensajes not_found

Valores posibles del campo message cuando status es not_found.

MensajeDescripción
El titular no tiene historial crediticio registrado en la fuenteLa persona existe pero nunca ha tenido un crédito reportado.
No se encontró una persona con los datos proporcionadosLa combinación de nombre, fecha de nacimiento y código postal no coincide con ningún registro.
El historial del titular está bloqueado por el propio titularEl titular activó un bloqueo de consultas sobre su historial.

Moneda

Valores posibles del campo moneda.

ValorDescripción
MXNPesos mexicanos. Es el valor por defecto.
USDDólares estadounidenses.
UDISUnidades de Inversión.

Clave MOP

Valores posibles de los campos claveMop e historicoPagos. Resume el comportamiento de pago de la cuenta en el periodo reportado.

ValorDescripción
01Pago puntual o con hasta 29 días de atraso.
02Atraso de 30 a 59 días.
03Atraso de 60 a 89 días.
04Atraso de 90 a 119 días.
05Atraso de 120 a 149 días.
06Atraso de 150 a 179 días.
07Cuenta en proceso de recuperación con quita o reestructura.
96Cuenta con atraso mayor a 180 días.
97Cuenta con adeudo sin recuperar.
99Cuenta fraudulenta reportada por el otorgante.
URCuenta sin información de pago en el periodo.

Estatus de cuenta

Valores posibles del campo cuentas[].estatusCuenta.

ValorDescripción
AL CORRIENTELa cuenta está vigente y sin pagos vencidos.
CON ATRASOLa cuenta está vigente pero con pagos vencidos.
LIQUIDADALa cuenta fue pagada en su totalidad y está cerrada.
LIQUIDADA CON QUITALa cuenta se cerró tras un acuerdo de pago por un monto menor al adeudo.
CEDIDAEl otorgante cedió la cartera a un tercero.
EN RECUPERACIONLa cuenta está en proceso de cobranza judicial o extrajudicial.

Tipo de contrato

Valores posibles del campo cuentas[].tipoContrato.

ValorDescripción
REVOLVENTELa línea se restablece conforme se paga, como en una tarjeta de crédito.
PAGOS FIJOSEl crédito se amortiza en pagos iguales durante un plazo definido.
HIPOTECARIOCrédito garantizado con un inmueble.
ARRENDAMIENTOContrato de arrendamiento financiero o puro.
SIN LIMITE PREESTABLECIDOLa línea no tiene un tope fijo y se revisa periódicamente.

Histórico

Endpoint

GEThttps://api.consultasnonstop.com/v1/circulo/reporte-pf/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": "c72a5f18d94b60e3a1c852f7",
  "status": "found",
  "autorizacion": "aut_9f3k28d1",
  "folioConsulta": "CNS-2026-0004815",
  "fechaConsulta": "2026-09-03",
  "rfc": "HEGM850101AB1",
  "nombres": "MARIA GUADALUPE",
  "primerApellido": "HERNANDEZ",
  "segundoApellido": "GOMEZ",
  "fechaNacimiento": "1985-01-01",
  "codigoPostal": "06700",
  "moneda": "MXN",
  "score": 743,
  "codigosRazon": ["A05", "B12", "C03"],
  "totalCuentas": 12,
  "cuentasAbiertas": 7,
  "cuentasCerradas": 5,
  "atrasosVigentes": 0,
  "peorAtrasoHistorico": 2,
  "saldoActualTotal": 184500,
  "creditoMaximoTotal": 320000,
  "pagoMensualTotal": 9800,
  "antiguedadHistorialMeses": 96,
  "consultasUltimos12Meses": 3,
  "cuentas": [
    {
      "otorgante": "BANCO EJEMPLO",
      "tipoContrato": "REVOLVENTE",
      "tipoCuenta": "TARJETA DE CREDITO",
      "numeroCuenta": "****4821",
      "fechaApertura": "2019-03-14",
      "fechaUltimoPago": "2026-08-28",
      "creditoMaximo": 80000,
      "saldoActual": 42300,
      "saldoVencido": 0,
      "pagoMensual": 3500,
      "claveMop": "01",
      "estatusCuenta": "AL CORRIENTE",
      "historicoPagos": "111111111111"
    },
    {
      "otorgante": "FINANCIERA EJEMPLO",
      "tipoContrato": "PAGOS FIJOS",
      "tipoCuenta": "CREDITO AUTOMOTRIZ",
      "numeroCuenta": "****9037",
      "fechaApertura": "2023-07-01",
      "fechaUltimoPago": "2026-08-15",
      "creditoMaximo": 240000,
      "saldoActual": 142200,
      "saldoVencido": 0,
      "pagoMensual": 6300,
      "claveMop": "01",
      "estatusCuenta": "AL CORRIENTE",
      "historicoPagos": "111111112111"
    }
  ]
}

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/circulo/reporte-pf

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/circulo/reporte-pf \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"autorizacion":"aut_9f3k28d1","nombres":"MARIA GUADALUPE","primerApellido":"HERNANDEZ","segundoApellido":"GOMEZ","fechaNacimiento":"1985-01-01","rfc":"HEGM850101AB1","codigoPostal":"06700","moneda":"MXN"}'

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 — EncontradoHEGM850101AB1
Caso exitoso — No encontradoXAXX010101000
Autorización inválidaAUTA800101AB2
Sin tokensSINC700303EF4
Error internoERRD650404GH5
Unavailable serviceUNAE600505IJ6

Endpoint histórico

GEThttps://sandbox.api.consultasnonstop.com/v1/circulo/reporte-pf/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/circulo/reporte-pf/historico/c72a5f18d94b60e3a1c852f7 \
  -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 c72a5f18d94b60e3a1c852f7.

Casoid
Caso exitosoc72a5f18d94b60e3a1c852f7
No encontrado0000000000000000ffffffff
Fuera de rango1111111111111111aaaaaaaa
Error interno2222222222222222bbbbbbbb
Crea tu cuenta →