Validate by CURP

Intro

This API lets you validate the CURP (Clave Unica de Registro de Población) against the RENAPO (Registro Nacional de Población) system.

Important points

Required parameters

The parameter called curp of the body request is required.

Validations

The following validations are applied to the curp parameter

  • Must be 18 characters long
  • Must comply with the format of a valid CURP

Response

You can find an examples of the different kinds of responses in the examples of the call.

There are some cases that return extraordinary information when a CURP is not valid, to understand more about it visit this article.

Test the service (test cases)

We have included a query parameter in Sandbox to enable you to query the test cases that we created for running tests. To get a response, fill the testCaseId parameter with any of the following cases:

NumIdNameDescription
1663567bb713cf2110a1106b1No encontradoIndicates that the CURP provided was not found in the RENAPO system
2663567bb713cf2110a1106b0Respuesta exitosaIndicates a successful response
3663567bb713cf2110a1106b2CURP inválidaIndicates that the CURP entered is not valid

📘

Test your own test case

In case you want to test your own test case created in link, you can send in the testCaseId parameter the identifier of the test case you want to use.

For more information visit our knowledge center to know more about test cases

Possible Errors

Required field

You will get a 400 bad request error when the curp parameter is not provided in the body request.

{
    "curp": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty"
}

Invalid format

You will get a 400 bad request error when the curp parameter does not comply with the correct format

{
    "curp": "FORMAT_ERROR; invalid curp format"
}

Test case not found

if a test case parameter is not sent or a value other than those mentioned above is sent, the service will return the following error 400 bad request

{
    "testCase": "EMPTY_ERROR; test case not found"
}

Service Unavailable

If the CURP system is not available, this endpoint will retrieve the next response:

{
    "id": "64405bb85a7fcc51545aa79b",
    "createdAt": "2023-04-19T15:23:04.834748-06:00",
    "finishedAt": "0001-01-01T00:00:00Z",
    "duration": 0,
    "status": "SERVICE_ERROR",
    "errorMessage": "error service unavailable",
    "request": {
        "curp": "ABCD970724HYNNNL07"
    }
}
Language
Authorization
Header
Click Try It! to start a request and see the response here!