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. |
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. |
Tag |
Type |
Required |
Description |
apikey |
string |
yes |
Customer key. |
v |
string |
optional |
Api version to use. |
{
"nombres": "string",
"apellidoPaterno": "string",
"apellidoMaterno": "string",
"sexo": "string",
"fechaNacimiento": "string",
"entidadNacimiento": "string"
}
Response:
Correct
Name |
Type |
Description |
codigoRespuesta |
string |
|
descripcionRespuesta |
string |
|
referencia |
string |
Operation reference |
statusOper |
string |
|
Message |
string |
|
tipoError |
string |
|
codigoError |
string |
|
sessionID |
string |
|
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 |
Tag |
Type |
Required |
Description |
apikey |
string |
yes |
Customer key. |
v |
string |
optional |
Api version to use. |
{
"curp": "string"
}
Response: ByCurp
Correct ByCurp
Name |
Type |
Description |
codigoRespuesta |
string |
|
descripcionRespuesta |
string |
|
referencia |
string |
Operation reference |
statusOper |
string |
|
Message |
string |
|
tipoError |
string |
|
codigoError |
string |
|
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 |
{
"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 |
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 |
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 |
Tlaxcala |
TL |
Tamaulipas |
TS |
Guanajuato |
GT |
Veracruz |
VZ |
Yucatán |
YN |
Zacatecas |
ZS |
Jalisco |
JC |
México |
MC |
Michoacán |
MN |
Morelos |
MS |
Nayarit |
NT |
Nuevo León |
NL |
Data returned by RENAPO
CURP status |
Descripción |
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. |
CURP001 |
|
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. |