API integral de datos de México en tiempo real API integral de datos de México en tiempo realGET Consulta de registros del IMSS

Consulta de registros del IMSS

GET/imss/query_by_curp-20%0.12 USDT/llamada0.096 USDT/llamada

Instrucciones 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 los registros de seguridad social del IMSS en México mediante la CURP o el NSS. [En mantenimiento; temporalmente no disponible]

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

  1. Crea una cuenta o usa la que ya tienes.
  2. Copia tu token de API en Cuenta → Seguridad.
  3. 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

Leer la guía de inicio

Encabezados

NombreTipoRequeridoDescripción
X-Api-TokenstringRequeridoTu token de API de la plataforma

Parámetros

NombreEnTipoRequeridoEjemploDescripción
curpquerystringRequeridoTEST900101HDFABC0118-character CURP code

Respuesta 200JSON

{
  "data": [
    {
      "nss": "00000000000",
      "curp": "TEST900101HDFABC01",
      "lastNamePaternal": "SAMPLE USER",
      "lastNameMaternal": "SAMPLE USER",
      "firstName": "SAMPLE USER",
      "gender": "SAMPLE VALUE",
      "genderCode": "2",
      "employmentRecords": [
        {
          "employerRegistration": "Y6084479",
          "modality": "10",
          "employerRFC": "XAXX010101000",
          "employerName": "SAMPLE ORGANIZATION",
          "stateName": "SAMPLE ORGANIZATION",
          "stateCode": "9",
          "dailyBaseSalary": "$1,530.26",
          "contributionDays": "28"
        }
      ]
    }
  ],
  "status": 200,
  "message": "Found",
  "success": true
}

Origen de los datos

En poder de
IMSS — Instituto Mexicano del Seguro Social Sitio oficial
Categoría de datos
Afiliación a seguridad social y NSS
País
México · Institución pública

API Pull no tiene una copia propia de este registro. Cada llamada se reenvía a la fuente indicada arriba y la respuesta se devuelve tal como llega; la exactitud y la disponibilidad dependen de esa fuente.

Todos los orígenes de datos y detalles de conservación →

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ódigoQué significa y qué hacer
200La 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.
402El saldo prepagado no cubría la llamada. La llamada no se realizó y no se cobró nada. Recarga y reintenta.
504La fuente original no respondió a tiempo. Reintenta después; es el modo de falla normal de registros lentos.
404La ruta no existe, o el endpoint ya no está publicado.
401Token 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.

Base legal (Términos §3)·Condiciones de uso completas