/verify/ine_check

1.API Specification
2.Request Params
3.Response Params
4.Error Codes
5.Sample

1.API Specification

This API is used to check if a credential is valid against the INE's nominal list..

Request Method

POST

Request URL

https://cloudapi.mexico.accuauth.com/verify/ine_check

Debugging Tool

Debugging Tool

2.Request Params

2.1 Request Header

Parameter Type Required Description
X-DF-API-ID string Yes For API credentials，Please visit API Request
X-DF-API-SECRET string Yes For API credentials，Please visit API Request

2.2 Request Body

Required Fields Type Description
optional cic string CIC of the id. Mandatory if credential type is D, E, F, G and H
optional identificadorCiudadano string Citizen identifier of the id. Mandatory if credential type is E, F, G or H.
optional ocr string OCR of the id. Mandatory if credential type is C or D.
optional claveElector string Voter Code. Mandatory if credential type is C.
optional numeroEmision string Emission number of the id. Mandatory if credential type is C.

3.Response Params

Fields Type Description
request_id string Unique id of each request
status string Response status, OK for success request, Error Codes for failed request
result_code string Result code
result_message string Result message
result object The verification result

3.1 Result Codes

Value Description Billable
0 Invalid or not exist Yes
1 Expired ID Yes
3 Valid ID Number Yes
4 INE Service error Yes
5 Invalid CIC Yes
6 Invalid OCR Yes
7 Invalid voter code Yes
8 Invalid emission number Yes
9 Valid ID with suspended voting right Yes
11 Valid only as ID No
12 Valid voter ID for foreign resident No

3.2 Elements in `result`

Fields Type Description
estatus string OK or ERROR
codigoValidacion string Validation code
cic string CIC
ocr string OCR
claveElector string Voter code
numeroEmision string Emission number
distritoFederal string Federal district
anioRegistro string Register year
anioEmision string Emission year
reporteRobo string
vigencia string Expiration date
informacionAdicional string Additional information
codigoMensaje string Same as result_code
Response Syntax
{
    "status": "OK",
    "result_code": "3",
    "result_message": "success",
    "result": {
        "estatus": "OK",
        "cic": "147704***",
        "claveElector": "VZOLIL8908160*****",
        "numeroEmision": "3",
        "distritoFederal": "10",
        "distritoLocal": "13",
        "ocr": "50720796*****",
        "anioRegistro": "2008",
        "anioEmision": "2016",
        "vigencia": "31 de diciembre de 2026",
        "mensaje": "Esta vigente como medio de identificación y puedes votar.",
        "claveMensaje": "3",
        "informacionAdicional": "Si tu Credencial Para Votar se emitió en 2013, podrás participar en la jornada electoral del próximo 02 de junio de 2024, posteriormente deberás agendar  una cita para acudir al módulo de atención ciudadana más cercano y  tramitar una nueva Credencial Para Votar",
        "codigoValidacion": "vi1709625631.168896"
    },
    "request_id": "TID43419cfde0a34a9d99199d77ce4e267e"
}

4.Error Codes

Common error codes of this API:

Http Status Code Status Field Description
400 INVALID_ARGUMENT Request parameter is invalid
400 VERIFY_FAILED Verify failed
400 ABNORMAL_BEHAVIOURS_DETECTED Request with same parameters repeated more than amount of times
401 UNAUTHORIZED Unauthorized or access is denied
401 KEY_EXPIRED Your API ID has expired
403 NO_PERMISSION You are not authorized to use this API
403 OUT_OF_QUOTA API calls quota exceeded
403 RATE_LIMIT_EXCEEDED API request frequency exceeds the limit
404 NOT_FOUND Requested API cannot be found
500 INTERNAL_ERROR Internal server error
512 SOURCE_SERVICE_UNAVAILABLE Source service is unavailable
513 SOURCE_SERVICE_TIMEOUT Source service is timeout

Comment: Please see the reason field for details when the above 40X / 51X error occurred

Response Syntax
{
  "status": "INVALID_ARGUMENT",
  "reason": "argument 'ocr': not found",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.Sample

results matching ""

    No results matching ""