Get Started

Quickstart

Make your first call against the CURPCheck API in under five minutes.

This guide walks you from zero to your first validated CURP. New accounts get a $5 USD signup credit, so you can hit the API immediately. Already have an RFCCheck account? Log in with it and skip to step 3.

1. Create an account

Sign up and confirm your email. Your $5 credit appears in your dashboard.

Create free account

2. Generate an API key

From the dashboard, open API Keys and create a new key. Keys are shown once, so copy yours into your secret manager before leaving the page.

3. Make your first call

The lookup endpoint costs 10 credits and returns the identity registered with RENAPO. Use a real CURP when making a request; the example below only illustrates the format.

curl bash
curl -X POST https://curpcheck.com/v1/curp/lookup \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"curp": "PEMJ800101HDFRRN07"}'

You should get back something like:

200 OK json
{
  "curp": "PEMJ800101HDFRRN07",
  "found": true,
  "message": "Identity retrieved from RENAPO",
  "person": {
    "curp": "PEMJ800101HDFRRN07",
    "names": "JUAN",
    "paternal_surname": "PEREZ",
    "mothers_maiden_name": "MARTINEZ",
    "birthdate": "01/01/1980",
    "sex": "HOMBRE"
  }
}

4. Pick the right endpoint

If you want… Use Cost
"Who is this CURP registered to?" /curp/lookup 10 credits
"What is this person's CURP?" /curp/search 10 credits

5. Handle errors

The API uses standard HTTP status codes. See Errors for the full list.