# CURP

Use this endpoint to verify a Mexican CURP (Clave Única de Registro de Población) number and get the personal data registered for it in the national population registry (RENAPO).
Our system converts the CURP number to uppercase before the check.
Each successful request is charged.
A field has the value `null` when no data is available for it.
Our system can also get the RFC (Registro Federal de Contribuyentes) number of the applicant by the CURP number. This happens automatically during the verification and does not need an API request.
To enable this, add the "Document" and "Tax ID" verification steps to the form in the Dashboard, and select the "Mexican RFC number" checkbox in the "Additional processing" block of the "Tax ID" step.
When the residence country of the applicant is Mexico, our system saves the RFC number as the `document_number` of the `TAX_ID_NUMBER` document. If our system cannot get the RFC number, the document number is empty. This option is charged for each verification.

Endpoint: GET /services/mx/curp/{curp_number}
Version: 1.0
Security: API-Key

## Security:

  - `API-Key` (unknown)
    apiKey in header API-Key

## Path parameters:

  - `curp_number` (string, required)

## Response 200:

  - `200` (unknown)
    **OK**
The request was successful, and our system returned an expected response.

## Response 200 fields (application/json):

  - `validation` (object)

  - `validation.valid` (boolean)
    Example: true

  - `data` (object)

  - `data.number` (string)
    CURP number in uppercase
    Example: EEPM900515HDFJRR00

  - `data.first_name` (string)
    Given names
    Example: MARIO

  - `data.last_name` (string)
    Paternal surname
    Example: EJEMPLO

  - `data.dob` (string)
    Date of birth in the YYYY-MM-DD format
    Example: 1990-05-15

  - `data.gender` (string)
    `M` — male, `F` — female
    Enum: "M", "F"

  - `data.residence_country` (string)
    ISO 3166-1 alpha-2 country code. The value is always `MX`
    Example: MX

## Response 402:

  - `402` (unknown)
    **Payment Required**
Access to the requested resource is restricted until a payment is successfully processed. Ensure your account has a valid payment method or sufficient funds to complete this action.

## Response 402 fields (application/json):

  - `type` (string)
    Example: insufficient_funds

  - `errors` (array)

## Response 403:

  - `403` (unknown)
    **Forbidden**
This request is not available for the current authentication method, mode, or plan.

## Response 403 fields (application/json):

  - `type` (string)
    Example: forbidden

  - `errors` (array)
    Example: []

## Response 422:

  - `422` (unknown)
    **Unprocessable Content**
The request was well-formed but contains invalid or unprocessable data, such as failed validation or incorrect field values.

## Response 422 fields (application/json):

  - `validation` (object)

  - `validation.valid` (boolean)
    Example: false

  - `data` (object)

  - `data.number` (string)
    Example: EEPM900515HDFJRR01

## Response 429:

  - `429` (unknown)
    **Too Many Requests**
This response indicates that a user has sent too many requests in a given amount of time.

## Response 429 fields (application/json):

  - `type` (string)
    Example: limit_exceeded

  - `errors` (array)

## Response 500:

  - `500` (unknown)
    **Internal Server Error**
This response indicates that our system encountered an unexpected condition that prevented it from fulfilling the request.

## Response 500 fields (application/json):

  - `type` (string)
    Example: internal_server

  - `errors` (array)

## Response 200 examples:

  - `Valid CURP number` (unknown)

## Response 422 examples:

  - `Invalid CURP number` (unknown)

