CURPv5 Validation API Documentation

Welcome to the documentation for the CURP Validation API. This API allows you to validate CURP (Clave Única de Registro de Población) through RENAPO services.

Overview

The CURP Validation API is a Validation service that provides comprehensive validation capabilities including personal data verification, document authentication, and status checks.

CURP Validation

Validate a CURP and retrieve associated personal information.

Endpoint and Description: POST ~/api/curp/bycurp

Parameters Headers:

Tag	Type	Required	Description
apikey	string	yes	Customer key

Request Body:

Parameter	Type	Required	Description
curp	string	yes	CURP to be validated

Request Example:

curl --location '~/api/curp/bycurp'
--header 'ApiKey: _apiKeyValue_'
--header 'Content-Type: application/json'
--data '{
    "curp": "CURP_TO_VALIDATE",
}'

Response:

200 Success Correct Response Example:

{
  "isCURPValid": "boolean",
  "curp": "string",
  "lastName": "string",
  "secondLastName": "string",
  "firstName": "string",
  "gender": "string",
  "birthDate": "string",
  "birthState": "string",
  "nationalityCode": "string",
  "proofDocumentType": 0,
  "curpStatus": "string",
  "inputDigest": "string",
  "outputDigest": "string",
  "timeStamp": "byte[]",
  "timeStampDigest": "string",
  "validationDate": "string",
  "ccbResponseCode": "string",
  "ccbResponseDescription": "string",
  "renapoResponseCode": "string",
  "renapoResponseDescription": "string",
  "warning": []
}

Response Fields:

Name	Type	Description
isCURPValid	boolean	Indicates if the CURP is valid
lastName	string	First last name
secondLastName	string	Second last name
firstName	string	First name
gender	string	Gender (M - F - X)
birthDate	string	Birth date
birthState	string	State of birth
nationalityCode	string	Nationality code
proofDocumentType	integer	Type of documentary proof: 1.- Acta Nacimiento 3.- Documento Migratorio 4.- Carta Naturalización 7.- Certificado de Nacionalidad Mexicana
curpStatus	string	CURP status. See StatusCurp List Code and description for possible values.
inputDigest	string	Input digest
outputDigest	string	Output digest
timeStamp	byte[]	Validation timestamp
timeStampDigest	string	Timestamp digest
validationDate	string	Validation date
ccbResponseCode	string	CCB response code
ccbResponseDescription	string	CCB response description
renapoResponseCode	string	RENAPO response code. See Renapo List Code and description for possible values.
renapoResponseDescription	string	RENAPO response description See Renapo List Code and description for possible values.

Error Estructure:

Name	Type	Description
Code	string	Error code
Message	string	Description of the error

Error Model:

{
  "error": "string", // Error code
  "message": "string" // Error message
}

Federal Entities Table

State	INE Code	RENAPO Code
Aguascalientes	01	AS
Baja California	02	BC
Baja California Sur	03	BS
Campeche	04	CC
Coahuila	05	CL
Colima	06	CM
Chiapas	07	CS
Chihuahua	08	CH
Ciudad de México	09	DF
Durango	10	DG
Guanajuato	11	GT
Guerrero	12	GR
Hidalgo	13	HG
Jalisco	14	JC
México	15	MC
Michoacán	16	MN
Morelos	17	MS
Nayarit	18	NT
Nuevo León	19	NL
Oaxaca	20	OC
Puebla	21	PL
Querétaro	22	QT
Quintana Roo	23	QR
San Luis Potosí	24	SP
Sinaloa	25	SL
Sonora	26	SR
Tabasco	27	TC
Tamaulipas	28	TS
Tlaxcala	29	TL
Veracruz	30	VZ
Yucatán	31	YN
Zacatecas	32	ZS

Service Error Message

Code	Message
CURPSV001	Access Denied. ApiKey header not found.
CURPSV002	Access Denied. Invalid ApiKey.
CURPSV003	Source Service has a connection problem.
CURPSV004	Invalid Format on CURP.
CURPSV005	Curp field is required.
CURPSV006	Service is not available.
CURPSV007	Service timed out.
CURPSV008	Internal server error.
CURPSV009	The CURP does not exist in the RENAPO database or have problem to validate.

Description of CCB parameter

Code	Description	English Description
CRGEN000	El proceso de validación se ha realizado exitosamente.	The validation process has been successfully completed.
CRCPR001	El campo CURP no cumple con el patrón de validación	The CURP field does not meet the validation pattern
CRCPR002	Error al conectarse con el servicio de RENAPO	Error connecting to the RENAPO service
CRCPR003	El campo CURP es un parámetro requerido	The CURP field is a required parameter

Renapo List Code and description

Code	Description	English Translation
01-06	La CURP no se encuentra en la base de datos	CURP not found in database
01-08	El documento probatorio está mal formado	Supporting document is malformed
01-09	La llave CURP no está bien formada	CURP key is malformed
01-14	No se pudo realizar su consulta, inténtelo nuevamente más tarde	Query could not be completed, please try again later
01-15	No se pudo desplegar los factores	Factors could not be displayed
01-18	Usuario no válido	Invalid user
02-01	Error al invocar al sistema de eCURP	Error while invoking eCURP system
02-02	Error al invocar al sistema de eCURP	Error while invoking eCURP system
02-03	Error al invocar al sistema de eCURP	Error while invoking eCURP system
03-01	{{Nombre Campo}} No cumple con el formato especificado	{{Field Name}} does not meet the specified format
04-01	La conexión con LDAP no se ha podido establecer satisfactoriamente	Connection to LDAP could not be established successfully
05-01	Error al procesar los parámetros de salida XML	Error processing XML output parameters

StatusCurp List Code and description

Active Curp:

Code	Description	English Description
AN	Alta Normal. Claves que desde su alta no han sufrido ningún tipo de cambio.	Normal Registration
AH	Alta con Homonimia. Claves con las primeras 16 posiciones de la CURP iguales a una que antecede, no necesariamente en datos de identidad o de registro.	Registration with Homonymy
RCN	Registro de Cambio No Afectado a CURP. Claves que sufrieron un cambio en datos de identidad o de registro sin afectar la conformación de ésta.	Change Registration Not Affected to CURP
RCC	Registro de Cambio Afectando a CURP. Claves que sufrieron un cambio en datos de identidad o de registro que afectaron la conformación de ésta.	Change Registration Affected to CURP

Inactive Curp:

Code	Description	English Description
BD	Baja por defunción.	Deregistration due to death
BSU	Baja sin Uso. Son claves que no presentan ningún tipo de movimiento desde su alta, esto es, no han sido consultadas, impresas, no tiene vivencia o algún movimiento.	Deregistration due to non-use
BAP	Baja por documento Apócrifo. Claves que se generaron con un documento no válido.	Deregistration due to apocryphal document
BDM	Baja Administrativa. Claves que generaron baja por una solicitud de alguna emisora de documento probatorio.	Deregistration due to administrative reasons
BDP	Baja por Adopción. Claves que generaron baja debido a los nuevos datos de identidad de una persona con adopción.	Deregistration due to adoption
BJD	Baja Judicial. Claves que generaron baja a solicitud de una orden judicial.	Deregistration due to judicial reasons

Status Codes

Status Code	Description
200	Successful validation
400	Invalid CURP format
404	Bad Request
401	Invalid credentials
503	Service unavailable
500	Internal server error
504	Timeout error