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.

Headers

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

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