Verification (v1.1.0)

Download OpenAPI specification:Download

Jorge Garduño: jorge@gendra.dev URL: https://remtools.io License: Apache 2.0

Servicios combinados: API de verificación de RFC consultando la base de datos oficial del SAT para validar vigencia y datos asociados | API de verificación de CURP consultando la base de datos oficial del RENAPO para validar vigencia y datos asociados | API de validación de credenciales de elector (INE) consultando la lista nominal del INE para verificar vigencia y datos asociados

Webhooks

Recibe los resultados de la validacion de INE Webhook

Authorizations:

api_keyapiKeyAuth

Request Body schema: application/json

valid	boolean Indica si la credencial es valida
messages	Array of strings
expired	boolean Indica si la credencial esta vencida
court_order	boolean Indica si la credencial tiene una orden de un juez
incorrect_data	boolean Indica si la credencial tiene datos incorrectos
cic	string Clave de identificación de ciudadano
elector_key	string <= 18 characters Clave de elector
ocr	string Numero OCR de la credencial
registered_at	string <= 4 characters Año de registro
emission_at	string <= 4 characters Año de emision
federal_district	string <= 3 characters Distrito federal
local_district	string <= 3 characters Distrito local
emission_number	string <= 2 characters Numero de emision

Responses

Request samples

Payload

Content type

application/json

{"valid": true,
"messages": ["Fecha de actualización de la información: 23 de noviembre del 2023 20:08",
"Fecha de consulta: 24 de noviembre del 2023"
],
"expired": false,
"court_order": false,
"incorrect_data": false,
"cic": "189082445",
"elector_key": "FRJMER94122309H903",
"ocr": "4102023451456",
"registered_at": "2016",
"emission_at": "2021",
"federal_district": "01",
"local_district": "01",
"emission_number": "01"
}

Recibe los errores de la validacion de INE Webhook

Authorizations:

api_keyapiKeyAuth

Request Body schema: application/json

valid	boolean Indica si la credencial es valida
error	string Mensaje de error

Responses

Request samples

Payload

Content type

application/json

{"valid": false,
"error": "INE website under maintenance"
}

RFC

Get RFC information

Get RFC information from the official government website.

Authorizations:

api_keyapiKeyAuth

Request Body schema: application/json

rfc required	string The RFC to search
name	string The name of the person or company required with the postal code
postal_code	string The postal code of the person or company required with the name

Responses

Request samples

Payload

Content type

application/json

{"rfc": "EKM1404018J1",
"name": "Eduardo",
"postal_code": "12345"
}

Response samples

200
422
500

Content type

application/json

Example

RfcResponse

{"success": true,
"result": {"rfc": "EKM1404018J1",
"valid_rfc": true,
"elegible_for_invoices": true,
"message": "RFC válido y susceptible de recibir facturas"
}
}

Reverse RFC information

Reverse RFC information from the official government website.

Authorizations:

api_keyapiKeyAuth

Request Body schema: application/json

name required	string The name of the person or company
first_last_name	string The first last name of the person, required for physical person
second_last_name	string The second last name of the person, required for physical person
birth_date required	string The birth date of the person
person_type required	string Enum: "PF" "PM" The person type, PF for physical person and PM for moral person
postal_code	string The postal code of the person or company, when provided with the name it will validate the RFC against the postal code

Responses

Request samples

Payload

Content type

application/json

{"name": "Margarita Gomez Velazquez",
"first_last_name": "Gomez",
"second_last_name": "Velazquez",
"birth_date": "1980-07-05",
"person_type": "PF",
"postal_code": "12345"
}

Response samples

200
422
500

Content type

application/json

{"success": true,
"result": {"rfc": "EKM1404018J1",
"valid_rfc": true,
"elegible_for_invoices": true,
"message": "RFC válido y susceptible de recibir facturas"
}
}

Reverse RFC and CURP information

Reverse RFC and CURP information from the official government website.

Authorizations:

api_keyapiKeyAuth

Request Body schema: application/json

curp

required

string

The CURP of the person

Responses

Request samples

Payload

Content type

application/json

{"curp": "GOVM800705MCLMLR01"
}

Response samples

200
404
422
500

Content type

application/json

{"success": true,
"result": {"rfc_result": {"rfc": "EKM1404018J1",
"valid_rfc": true,
"elegible_for_invoices": true,
"message": "RFC válido y susceptible de recibir facturas"
},
"curp_result": {"curp": "GOVM800705MCLMLR01",
"valid": true,
"names": "Margarita",
"first_last_name": "Gomez",
"second_last_name": "Velazquez",
"birth_date": "1980-07-05",
"gender": "M",
"nationality": "MEX",
"birth_federal_entity": "COL",
"issuing_entity_key": "06",
"curp_status": "AN",
"curp_status_description": "Alta Normal",
"registration_year": "1980",
"certificate_folio": "",
"registration_entity_number": "10",
"municipality_key": "001",
"foreign_registration_number": "",
"probatory_document": "Acta de nacimiento",
"probatory_document_data": {"id": "1",
"name": "Acta de nacimiento",
"book": "",
"act_number": "1",
"sheet": "1",
"tomo": "",
"crip": "",
"letter_folio": ""
}
}
}
}

CURP

Obtener información de la CURP

Tomando en cuenta la CURP proporcionada, se obtiene la información de la persona registrada en la base de datos de RENAPO

Authorizations:

ApiKeyAuth

Request Body schema: application/json

CURP data

curp

required

string = 18 characters

Responses

Request samples

Payload

Content type

application/json

{"curp": "XXXX910225XXXXXX09"
}

Response samples

Content type

application/json

{"result": {"birth_date": "1990-01-01",
"birth_federal_entity": "DF",
"certificate_folio": "9999",
"curp": "XXXX910225XXXXXX09",
"curp_status": "RCC",
"curp_status_description": "Registro Normal",
"first_last_name": "XXXX",
"foreign_registration_number": "9999",
"gender": "H",
"issuing_entity_key": "99999",
"municipality_key": "999",
"name": "XXXX",
"nationality": "MEX",
"probatory_document": "",
"probatory_document_data": {"act_number": "99999",
"book": "9999",
"crip": "090050291018921",
"id": "1",
"letter_folio": "9999",
"name": "Acta de nacimiento",
"sheet": "9999",
"tome": "9999"
},
"registration_entity_number": "09",
"registration_year": "2000",
"second_last_name": "XXXX",
"valid": true
},
"success": true
}

Obtener la CURP de una persona a partir de sus datos personales

En base a los datos proporcionados de una persona, se obtiene la CURP correspondiente de la base de datos de RENAPO

Authorizations:

ApiKeyAuth

Request Body schema: application/json

Información para obtener la CURP

birth_date required	string <date> Date format YYYY-MM-DD
birth_federal_entity required	string Enum: "AS" "BC" "BS" "CC" "CL" "CM" "CS" "CH" "DF" "DG" "GT" "GR" "HG" "JC" "MC" "MN" "MS" "NT" "NL" "OC" "PL" "QT" "QR" "SP" "SL" "SR" "TC" "TS" "TL" "VZ" "YN" "ZS"
first_last_name required	string
gender required	string Enum: "H" "M" "X"
name required	string
second_last_name required	string

Responses

Request samples

Payload

Content type

application/json

{"birth_date": "1990-01-01",
"birth_federal_entity": "AS",
"first_last_name": "Doe",
"gender": "H",
"name": "John",
"second_last_name": "Smith"
}

Response samples

Content type

application/json

{"result": {"birth_date": "1990-01-01",
"birth_federal_entity": "DF",
"certificate_folio": "9999",
"curp": "XXXX910225XXXXXX09",
"curp_status": "RCC",
"curp_status_description": "Registro Normal",
"first_last_name": "XXXX",
"foreign_registration_number": "9999",
"gender": "H",
"issuing_entity_key": "99999",
"municipality_key": "999",
"name": "XXXX",
"nationality": "MEX",
"probatory_document": "",
"probatory_document_data": {"act_number": "99999",
"book": "9999",
"crip": "090050291018921",
"id": "1",
"letter_folio": "9999",
"name": "Acta de nacimiento",
"sheet": "9999",
"tome": "9999"
},
"registration_entity_number": "09",
"registration_year": "2000",
"second_last_name": "XXXX",
"valid": true
},
"success": true
}

INE

Valida un INE

Authorizations:

api_keyapiKeyAuth

query Parameters

webhook

required

string

Request Body schema: application/json

cic required	string requerido para los tipos D y EFGH
ocr required	string
elector_key	string <= 18 characters
emission_number	string <= 2 characters

Responses

Request samples

Payload

Content type

application/json

{"cic": "189082445",
"ocr": "4102023451456",
"elector_key": "FRJMER94122309H903",
"emission_number": "01"
}

Response samples

200
400
422

Content type

application/json

{"webhook_uuid": "11ea1db3-664d-49f3-abdc-610b3b1ff546",
"timestamp": 1647643650116
}