/v1/sessions/{id}/decision/combined-ine-curp-registry

  • Updated on Mar 18, 2025
  • Published on Jan 30, 2025
Get
/v1/sessions/{id}/decision/combined-ine-curp-registry

Returns combined result of INE/IFE and CURP.

INE (Institutio Nacional Electoral - Mexican Electoral Registry) is the organization that issues the voter ID cards and maintains the voters registry.

The CURP (Unique Key of Population Registry) is the name of the population number/certificate in Mexico.

ifeIdentifier and ineIdentifier both represent person's identification number. ife is a legacy name, it was changed to ine.


Note: always ensure that you use the correct API URL to send requests. See the API URL section for more info.



Security
API Key
Header parameter namex-auth-client

Your integration's API key (occasionally referred to the "Token", "API public key" or "Publishable key")

Header parameters
x-hmac-signature
stringRequired

Session id signed with the shared secret key

Path parameters
id
stringRequired

Session id

Query parameters
version
stringRequired
Responses
200

Result of the combined-ine-curp-registry check

Expand All
object
data
object

Data related to the INE/IFE identification number and the CURP identification number

ine
object

Details about the INE/IFE identification number

active
boolean

Indication of if the INE identification number is active (true) or inactive (false)

ExampleTrue
status
string

Explanation of the data.status value

ExampleLa credencial esta vigente
information
string

Extra information about the INE identification number

ExampleCIC 000000000 Clave de elector JRLGLS00000000H000 Número de emisión 1 Distrito Federal 3 Distrito Local 4 Número OCR 0000000000000 Año de registro 2009 Año de emisión 2020 Fecha de actualización de la información: 10 de agosto del 2023 19:48 Fecha de consulta: 11 de agosto del 2023 Esta vigente como medio de identificación y puedes votar. Tus datos se encuentran en el Padrón Electoral, y también en la Lista Nominal de Electores. Será válida hasta el 31 de diciembre de 2030
comments
Array of string

Array of comments regarding the status of the identification

Example[ "Fecha de consulta: 11 de agosto del 2023", "Tus datos se encuentran en el Padrón Electoral, y también en la Lista Nominal de Electores" ]
string
ifeIdentifier
string | null

INE identification number. When this is returned, the ineIdentifier is not present

Example''
ineIdentifier
string | null

IFE identification number. When this is returned, the ifeIdentifier is not present

Example000000000
curp
object

Details about the CURP identification number

curp
string

CURP identification number

ExampleABCD000000HVZRGS00
names
string

Person's name

Example
gender
string

Person's gender (One of HOMBRE, MUJER)

ExampleHOMBRE
regionCode
string

Region code

ExampleVZ
statusCurp
string | null

Status of the CURP data (One of: AN, AH, CRA CU, RCN, RCC, BD, BDA, BCC, BCN)

ExampleRCN
descriptionStatusCurp
string

Explanation of the details.curp.statusCurp value

ExampleRegistro de cambio no afectando a curp
birthRegion
string

Person's birth region

ExampleVeracruz
dateOfBirth
string (DD/MM/YY)

Person's date of birth

Example06/04/1991
nationality
string

Person's nationality

ExampleMEX
firstSurname
string

Person's first surname

ExampleJUAREZ
secondSurname
string

Person's last surname

ExampleLAGUNES
docEvidenceData
object

Details about the document evidence data

book
string

Book

Example5
sheet
string

Sheet

Example4
volume
string

Volume

Example2
actNumber
string

Act number

Example001234
registryCity
string

Registry city

Example
regionRegistry
string

Registry region

Example30
registrationYear
string

Registration year

Example2009
registryCityCode
string

Registry city code

Example4
registryRegionCode
string

Registry region code

ExampleVZ
documentEvidence
number (integer)

Document evidence

Example1
400

Bad request

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleValidation failed
401

Unauthorized

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleMandatory X-AUTH-CLIENT header containing the API key is missing from the request.
404

Session not found

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleResource not found
500

Internal server error

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleSomething went wrong