CURP Service V2

CURP API gives the service of CURP (Clave Única de Registro de Población) query, you only need to give birth-data or client id. Also, you can search client data giving CURP values. Both types of methods return same data. * it means Unique id of population register. It´s an id for Mexican people, there only can be one for each person.

Description

Validation ByData

This method makes the consult of CURP when you give biographic data.

Endpoint of byData

~/api/Business/Curp/bydata?v=2

Parameters

Tag	Type	Required	Maximum lenght	Description
nombres	string	yes	50	Names.
apellidoPaterno	string	yes	50	First surname .
apellidoMaterno	string	yes	50	Second surname.
sexo	string	yes	1	Gender: “H” For man and “M” for woman or "X" for non binary.
fechaNacimiento	string	yes	10	Birthdate: dd/mm/yyyy. Example August 2 of 1990 02/08/1990.
entidadNacimiento	string	yes	2	Birth entity: Read the table 1.

Headers

Tag	Type	Required	Description
apikey	string	yes	Customer key.
v	string	optional	Api version to use.

FormData

{
  "nombres": "string",
  "apellidoPaterno": "string",
  "apellidoMaterno": "string",
  "sexo": "string",
  "fechaNacimiento": "string",
  "entidadNacimiento": "string"
}

Response:

Correct

Name	Type	Description
codigoRespuesta	string	Answer code
descripcionRespuesta	string	Answer description
referencia	string	Operation reference
statusOper	string	Operation status
Message	string	Status description
tipoError	string	Type error
codigoError	string	Error code
sessionID	string	Id’s session
resultCURPS
CURP	string	Clave Única de Registro de Población
apellidoPaterno	string	First surname
apellidoMaterno	string	Second surname
Nombres	string	Names
Sexo	string	Gender
fechNac	string	Birthdate
Nacionalidad	string	Nationality
docProbatorio	string	Type of the probatory document
anioReg	string	Year of register
Foja	string	Sheet number
tomo	string	Tome
libro	string	Book
numActa	string	Act number
CRIP	string	Register code and Personal id
numEntidadReg	string	Number of register place
cveMunicipioReg	string	Code of register place
NumRegExtranjeros	string	Number of National registry of Foreigners
FolioCarta	string	Folio carta
cveEntidadNac	string	State of birth code
cveEntidadEmisora	string	Issuing state code
statusCurp	string	CURP Status

Validation ByCURP

This method allows you to consult client data when you give the CURP.

Endpoint ByCurp

~/api/Business/Curp/bycurp?v=2

Parameters ByCurp

Tag	Type	Required	Description
CURP	string	yes	Clave Única de Registro de Población

Headers ByCurp

Tag	Type	Required	Description
apikey	string	yes	Customer key.
v	string	optional	Api version to use.

FormData ByCurp

{
  "curp": "string"
}

Response: ByCurp

Correct ByCurp

Name	Type	Description
codigoRespuesta	string	Answer code
descripcionRespuesta	string	Answer description
referencia	string	Operation reference
statusOper	string	Operation status
Message	string	Status description
tipoError	string	Type error
codigoError	string	Error code
sessionID	string	Id’s session
resultCURPS
CURP	string	Clave Única de Registro de Población
apellidoPaterno	string	First Surname
apellidoMaterno	string	Second Surname
Nombres	string	Names
Sexo	string	Gender
fechNac	string	Birthdate
Nacionalidad	string	Nationality
docProbatorio	string	Type of the probatory document
anioReg	string	Year of register
Foja	string	Sheet number
tomo	string	Tome
libro	string	Book
numActa	string	Act number
CRIP	string	Register code and Personal id
numEntidadReg	string	Number of register place
cveMunicipioReg	string	Code of register place
NumRegExtranjeros	string	Number of National registry of Foreigners
FolioCarta	string	Folio carta
cveEntidadNac	string	State of birth code
cveEntidadEmisora	string	Issuing state code
statusCurp	string	CURP Status

JSON file

{
  "codigoRespuesta": "string",
  "descripcionRespuesta": "string",
  "referencia": "string",
  "respuestaRENAPO": {
    "curpStatus": {
      "statusOper": "string",
      "message": "string",
      "tipoError": "string",
      "codigoError": "string",
      "sessionID": "string",
      "resultCURPS": {
        "curp": "string",
        "apellidoPaterno": "string",
        "apellidoMaterno": "string",
        "nombres": "string",
        "sexo": "string",
        "fechNac": "string",
        "nacionalidad": "string",
        "docProbatorio": "string",
        "anioReg": "string",
        "foja": "string",
        "tomo": "string",
        "libro": "string",
        "numActa": "string",
        "crip": "string",
        "numEntidadReg": "string",
        "cveMunicipioReg": "string",
        "numRegExtranjeros": "string",
        "folioCarta": "string",
        "cveEntidadNac": "string",
        "cveEntidadEmisora": "string",
        "statusCurp": "string"
      }
    }
  }
}

Error structure

Name	Type	Description
code	string	Error code
message	string	Error message
fullMessage	string	Full description of the error

Error Model:

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

Table 1. Federal entities

State	Code
Aguascalientes	AS
Baja California	BC
Baja California Sur	BS
Campeche	CC
Chiapas	CS
Chihuahua	CH
Coahuila	CL
Colima	CM
Distrito Federal	DF
Durango	DG
Guanajuato	GT
Guerrero	GR
Hidalgo	HG
Jalisco	JC
México	MC
Michoacán	MN
Morelos	MS
Nayarit	NT
Nuevo León	NL
Oaxaca	OC
Puebla	PL
Querétaro	QT
Quintana Roo	QR
San Luis Potosí	SP
Sinaloa	SL
Sonora	SR
Tabasco	TC
Tamaulipas	TS
Tlaxcala	TL
Veracruz	VZ
Yucatán	YN
Zacatecas	ZS

Table 2. Foreigners

Nationality status	Detail	Description
NE	Foreign nationality	That NE value means that the person has the Mexican CURP even if they have foreign nationality.

Data returned by RENAPO

CURP status	Description	Description	Response to clients	Registration status
AN	Alta Normal	Normal registration	AN	Active
AH	Alta con Homonimia	Registration with homonymy	AH	Active
RCC	Registro de cambio afectando a CURP	Change affecting CURP.	RCC	Active
RCN	Registro de cambio no afectando a CURP	Change not affecting CURP	RCN	Active
BAP	Baja por documento apócrifo	Low due to apocryphal document.	BAP	Inactive
BSU	Baja sin uso	Low curp without use	BSU	Inactive
BD	Baja por defunción	Low curp due to death	BD	Inactive
BDM	Baja administrativa	Low, due to administrative process	BDM	Inactive
BDP	Baja por adopción	Low, due to adoption	BDP	Inactive
BJD	Baja Judicial	Low for judicial reasons	BJD	Inactive

Service errors

Code	Message	FullMessage
CURP000	El servicio de RENAPO no se encuentra disponible.	RENAPO service is not available.
CURP001	No data were found to consult.	No data were found to consult.
CURP003	Error on request information.	Error processing your request, please try again.
CURP004	Apikey invalid	Access Denied - Header Apikey not Found.
CURP005	The nombres is required or invalid.	Message displayed when name value is not entered or invalid characters are entered as numbers.
CURP006	The apellidoPaterno is required or invalid.	Message displayed when the value of the paternal last name is not entered or when invalid characters are entered as numbers.
CURP007	The apellidoMaterno is invalid.	Message displayed when the value of the mother's last name is not entered or when invalid characters are entered as numbers.
CURP008	The sexo field is required or invalid.	Message displayed when gender value null or incorrect.
CURP009	The fechaNacimiento field is required or invalid.	Message displayed when the value of the date of birth is null or when invalid characters such as \$ # $! #% are entered.
CURP010	The entidadNacimiento Field is required or invalid.	Message displayed when the correct birth status value is not entered or when invalid characters such as # $% &% $ & are entered.
CURP011	The CURP field is not in the allowed format.	Message displayed when the value of the CURP is null or when invalid format are entered.
CURP018	Something was wrong, we're working on the failure. Please try again.	Something was wrong, We're working on the failure. Please try again.
CURP019	Empty data response from RENAPO, please verify data request.	Empty data response from RENAPO, please verify data request.
CURPDOC005	CURP service is not available.	Message displayed when curp service is not available.