RENAPO1 tokenPOST

CURP por Datos Generales

Consulta la CURP en RENAPO a partir de los datos personales: nombres, apellidos, fecha de nacimiento, sexo y entidad de registro. Útil cuando el usuario no recuerda su CURP en flujos de onboarding digital.

Endpoint

POSThttps://api.datosnonstop.com/v1/renapo/datos-generales

Parámetros

json

{
  "claveEntidad": "YN",
  "fechaNacimiento": "1987-07-25",
  "nombres": "USUARIO EDUARDO",
  "primerApellido": "RAMIREZ",
  "segundoApellido": "VAZQUEZ",
  "sexo": "H"
}

ParámetroTipoRequeridoDescripción

claveEntidadstringSíClave de 2 caracteres de la entidad de nacimiento.

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

nombresstringSíNombres de pila tal como aparecen en el acta de nacimiento.

primerApellidostringSíPrimer apellido de la persona.

segundoApellidostringNoSegundo apellido de la persona. Opcional cuando la persona no tiene segundo apellido.

sexostringSíClave del sexo registrado: H, M o X.

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.datosnonstop.com/v1/renapo/datos-generales \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"claveEntidad":"YN","fechaNacimiento":"1987-07-25","nombres":"USUARIO EDUARDO","primerApellido":"RAMIREZ","segundoApellido":"VAZQUEZ","sexo":"H"}'

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": "8b4c923f5e9b2d6f0a38c152",
  "status": "found",
  "curp": "RAVU870725HYNMZS09",
  "nombres": "USUARIO EDUARDO",
  "primerApellido": "RAMIREZ",
  "segundoApellido": "VAZQUEZ",
  "sexo": "HOMBRE",
  "fechaNacimiento": "1987-07-25",
  "nacionalidad": "MEXICO",
  "entidadNacimiento": "YUCATAN",
  "estatusCurp": "ALTA NORMAL",
  "documentoProbatorio": {
    "tipo": "ACTA DE NACIMIENTO",
    "anioRegistro": "1987",
    "numeroActa": "00789",
    "entidadRegistro": {
      "clave": "31",
      "descripcion": "YUCATAN"
    },
    "municipioRegistro": {
      "clave": "050",
      "descripcion": "MERIDA"
    },
    "foja": null,
    "libro": null,
    "tomo": null,
    "numeroDocumento": null,
    "paisOrigen": null,
    "fechaVencimiento": null,
    "numeroCarta": null,
    "fechaOtorgamiento": null,
    "numeroCertificado": null,
    "numeroTramite": null,
    "tipoTramite": null,
    "dependenciaEmisora": null,
    "fechaEmision": null
  }
}

Respuestas en error

JSON

400 Bad Request

{
  "error": "empty_field",
  "message": "El campo 'primerApellido' es requerido",
  "field": "primerApellido"
}

Campos

Campos de entrada

CampoTipoDescripción

claveEntidadstringClave de 2 caracteres de la entidad federativa donde se registró el nacimiento. Ver catálogo Clave de entidad.

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

nombresstringNombres de pila tal como aparecen en el documento probatorio. Aceptado en mayúsculas o minúsculas; RENAPO normaliza el valor.

primerApellidostringPrimer apellido de la persona.

segundoApellidostringSegundo apellido de la persona. Opcional cuando la persona no tiene segundo apellido registrado.

sexostringClave del sexo registrado: H, M o X. Ver catálogo Sexo (entrada).

Campos de respuesta

CampoTipoDescripción

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

statusstringResultado de la consulta de los datos generales en RENAPO. Ver catálogo Status.

curpstringCURP devuelta por RENAPO tras la consulta (18 caracteres). Solo está presente cuando status es found.

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

claveEntidadstringClave de entidad enviada en la consulta. Solo está presente en respuestas not_found. Ver catálogo Clave de entidad.

nombresstringNombres de pila registrados en el documento probatorio. En respuestas not_found ecoa el valor enviado en la consulta.

primerApellidostringPrimer apellido registrado en el documento probatorio. En respuestas not_found ecoa el valor enviado en la consulta.

segundoApellidostringSegundo apellido registrado en el documento probatorio. En respuestas not_found ecoa el valor enviado en la consulta.

sexostringSexo registrado en RENAPO. En respuestas not_found ecoa la clave (H, M o X) enviada en la consulta. Ver catálogo Sexo.

fechaNacimientostringFecha de nacimiento en formato ISO YYYY-MM-DD. En respuestas not_found ecoa el valor enviado en la consulta.

nacionalidadstringNacionalidad registrada en RENAPO. Solo está presente cuando status es found.

entidadNacimientostringEntidad federativa donde se registró el nacimiento. Solo está presente cuando status es found.

estatusCurpstringEstatus vigente del registro en RENAPO. Solo está presente cuando status es found. Ver catálogo Estatus CURP.

documentoProbatorioobjectDocumento oficial que sustenta el registro de la CURP. Solo está presente cuando status es found.

documentoProbatorio.tipostringTipo de documento probatorio. Ver catálogo Tipo de documento probatorio.

documentoProbatorio.anioRegistrostringAño en que se registró el documento probatorio.

documentoProbatorio.numeroActastringNúmero de acta asignado al registro.

documentoProbatorio.entidadRegistro.clavestringClave de la entidad federativa donde se realizó el registro.

documentoProbatorio.entidadRegistro.descripcionstringNombre de la entidad federativa donde se realizó el registro.

documentoProbatorio.municipioRegistro.clavestringClave del municipio donde se realizó el registro.

documentoProbatorio.municipioRegistro.descripcionstringNombre del municipio donde se realizó el registro.

documentoProbatorio.fojastring | nullFoja donde aparece el registro del acta (cuando aplica).

documentoProbatorio.librostring | nullLibro donde aparece el registro del acta (cuando aplica).

documentoProbatorio.tomostring | nullTomo donde aparece el registro del acta (cuando aplica).

documentoProbatorio.numeroDocumentostring | nullNúmero del documento probatorio cuando no es acta de nacimiento.

documentoProbatorio.paisOrigenstring | nullPaís de origen del documento probatorio extranjero (cuando aplica).

documentoProbatorio.fechaVencimientostring | nullFecha de vencimiento del documento probatorio en formato ISO.

documentoProbatorio.numeroCartastring | nullNúmero de carta de naturalización (cuando aplica).

documentoProbatorio.fechaOtorgamientostring | nullFecha en que se otorgó el documento probatorio en formato ISO.

documentoProbatorio.numeroCertificadostring | nullNúmero de certificado relacionado con el documento (cuando aplica).

documentoProbatorio.numeroTramitestring | nullNúmero de trámite asociado al documento probatorio.

documentoProbatorio.tipoTramitestring | nullTipo de trámite asociado al documento probatorio.

documentoProbatorio.dependenciaEmisorastring | nullDependencia oficial que emitió el documento probatorio.

documentoProbatorio.fechaEmisionstring | nullFecha de emisión del documento probatorio en formato ISO.

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ó una CURP que coincide con los datos enviados. La respuesta incluye los datos del titular.

not_foundNo se encontró una CURP que coincida con los datos enviados en RENAPO. La respuesta incluye el campo message con el detalle.

Clave de entidad

Catálogo de claves de 2 caracteres usadas en el campo claveEntidad para identificar la entidad federativa de nacimiento.

ClaveDescripción

ASAGUASCALIENTES

BCBAJA CALIFORNIA

BSBAJA CALIFORNIA SUR

CCCAMPECHE

CLCOAHUILA

CMCOLIMA

CSCHIAPAS

CHCHIHUAHUA

DFCIUDAD DE MÉXICO

DGDURANGO

GTGUANAJUATO

GRGUERRERO

HGHIDALGO

JCJALISCO

MCESTADO DE MÉXICO

MNMICHOACÁN

MSMORELOS

NTNAYARIT

NLNUEVO LEÓN

OCOAXACA

PLPUEBLA

QTQUERÉTARO

QRQUINTANA ROO

SPSAN LUIS POTOSÍ

SLSINALOA

SRSONORA

TCTABASCO

TSTAMAULIPAS

TLTLAXCALA

VZVERACRUZ

YNYUCATÁN

ZSZACATECAS

NENACIDO EN EL EXTRANJERO

Sexo (entrada)

Claves aceptadas en el campo sexo de la consulta.

ClaveDescripción

HHOMBRE

MMUJER

XNO BINARIO

Sexo

Valores posibles del campo sexo en la respuesta found.

ValorDescripción

HOMBREPersona registrada como hombre.

MUJERPersona registrada como mujer.

NO BINARIOPersona registrada con identidad de género no binaria.

Estatus CURP

Valores posibles del campo estatusCurp que reporta RENAPO sobre la vigencia del registro.

ValorDescripción

ALTA NORMALRegistro estándar de una clave vigente y sin irregularidades.

ALTA POR HOMONIMIARegistro generado para distinguir a una persona de otra con datos de identidad idénticos.

REGISTRO POR CAMBIO QUE AFECTA LA CLAVEClave que fue modificada tras una corrección en los datos básicos de identidad (como fecha de nacimiento o apellidos).

REGISTRO POR CAMBIO QUE NO AFECTA LA CLAVEActualización de la información en el sistema que no requirió alterar los 18 caracteres de la clave original.

BAJA POR DOCUMENTO APOCRIFOInvalidación de la clave por haber sido tramitada con documentos falsos o no oficiales.

BAJA POR FALTA DE USOClave desactivada preventivamente por no registrar consultas, impresiones ni movimientos desde su emisión.

BAJA POR DEFUNCIONCancelación definitiva de la clave debido al fallecimiento del titular.

BAJA ADMINISTRATIVADesactivación realizada a petición de la institución emisora debido a errores en el proceso de registro.

BAJA POR ADOPCIONEliminación de la clave anterior para proteger la privacidad y actualizar la identidad legal del adoptado.

BAJA POR ORDEN JUDICIALDesactivación de la clave instruida por el mandato de un juez o autoridad legal competente.

Tipo de documento probatorio

Valores posibles del campo documentoProbatorio.tipo.

ValorDescripción

ACTA DE NACIMIENTOEs el documento base emitido por el Registro Civil que acredita el nacimiento de una persona en territorio nacional.

DOCUMENTO MIGRATORIODocumento expedido por las autoridades correspondientes para acreditar la estancia legal y la identidad de extranjeros en el país.

CARTA DE NATURALIZACIONDocumento que otorga la nacionalidad mexicana a un extranjero que ha cumplido con los requisitos legales para obtenerla.

CERTIFICADO DE NACIONALIDAD MEXICANADocumento que acredita la condición de mexicano por nacimiento de quienes tienen otra nacionalidad y no han sido registrados previamente.

TRAMITE ANTE LA SEGOBRegistro gestionado directamente ante la Secretaría de Gobernación para casos administrativos especiales o regularizaciones de identidad.

Histórico

Endpoint

GEThttps://api.datosnonstop.com/v1/renapo/datos-generales/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": "8b4c923f5e9b2d6f0a38c152",
  "status": "found",
  "curp": "RAVU870725HYNMZS09",
  "nombres": "USUARIO EDUARDO",
  "primerApellido": "RAMIREZ",
  "segundoApellido": "VAZQUEZ",
  "sexo": "HOMBRE",
  "fechaNacimiento": "1987-07-25",
  "nacionalidad": "MEXICO",
  "entidadNacimiento": "YUCATAN",
  "estatusCurp": "ALTA NORMAL",
  "documentoProbatorio": {
    "tipo": "ACTA DE NACIMIENTO",
    "anioRegistro": "1987",
    "numeroActa": "00789",
    "entidadRegistro": {
      "clave": "31",
      "descripcion": "YUCATAN"
    },
    "municipioRegistro": {
      "clave": "050",
      "descripcion": "MERIDA"
    },
    "foja": null,
    "libro": null,
    "tomo": null,
    "numeroDocumento": null,
    "paisOrigen": null,
    "fechaVencimiento": null,
    "numeroCarta": null,
    "fechaOtorgamiento": null,
    "numeroCertificado": null,
    "numeroTramite": null,
    "tipoTramite": null,
    "dependenciaEmisora": null,
    "fechaEmision": null
  }
}

Respuestas en error

JSON

404 Not Found

{
  "error": "not found",
  "message": "el id no fue encontrado en el historico"
}

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/renapo/datos-generales

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

Casos de prueba

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

CasoCampoprimerApellido

Caso exitoso — EncontradoprimerApellidoRAMIREZ

Caso exitoso — No encontradoprimerApellidoNOEXISTE

Empty fieldprimerApellidoEMPTY

Invalid formatclaveEntidadZZ

Sin tokensprimerApellidoSINTOKENS

Error internoprimerApellidoERROR

Unavailable serviceprimerApellidoUNAVAILABLE

Endpoint histórico

GEThttps://sandbox.api.datosnonstop.com/v1/renapo/datos-generales/historico/{id}

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

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 8b4c923f5e9b2d6f0a38c152.

Casoid

Caso exitoso8b4c923f5e9b2d6f0a38c152

No encontrado0000000000000000ffffffff

Fuera de rango1111111111111111aaaaaaaa

Error interno2222222222222222bbbbbbbb

Empezar gratis →