# Validación de CURP ante RENAPO

Fuente: /renapo/curp-validation/

Este endpoint utiliza la CURP de una persona para hacer una consulta ante la RENAPO y asi validar que la CURP sea correcta y valida.

**Método:**   POST

#### **Endpoint**

```
https://api.verificamex.com/identity/v1/scraping/renapo

```

> **Nota**
>
> Recuerda que debes tener un token válido para realizar la solicitud.
> Puedes obtener un token siguiendo los pasos descritos en la sección [Generar tokens](/authentication/generate-tokens/).

### **Encabezados de la Solicitud**

Para realizar la solicitud es necesario incluir los siguientes encabezados:

| Encabezado | Valor | Descripción |
| - | - | - |
| Accept | `application/json` | Tipo de contenido de la solicitud. |
| Authorization | `Bearer {tu_token}` | Token generado para autenticar al usuario. |

### **Cuerpo de la Solicitud**

El cuerpo de la solicitud debe contener los siguientes parámetros:

| Parámetro | Tipo | Descripción |
| - | - | - |
| curp | `String` | CURP de la persona a validar. |
| `pdf_required` | `Boolean` | *Opcional.* Si se envía en `true`, además de los datos de RENAPO se solicita la **constancia de CURP en PDF**. Por defecto es `false`. |
| webhook | `String` | *Obligatorio si `pdf_required` es `true`.* URL a la que se notificará el PDF cuando no se pueda entregar en la misma respuesta. Debe ser una URL válida. Ver [Webhook de constancia CURP](/renapo/curp-pdf-webhook/). |

> **Costo en tokens**
>
> Consultar únicamente los datos de la CURP cuesta **3 tokens**. Si además pides la constancia en PDF (`pdf_required: true`) el costo sube a **20 tokens**, se entregue o no el PDF en esa misma respuesta: solicitarlo siempre pone en marcha su generación.

### **¿Cómo se entrega la constancia en PDF?**

Al enviar `pdf_required: true`, Verificamex primero revisa si ya cuenta con esa constancia:

- **Si ya está disponible**, el PDF llega **en la misma respuesta**, en el campo `pdf` (codificado en base64).
- **Si no está disponible**, la generación queda en curso: la respuesta **no incluye el campo `pdf`** y, en cuanto la constancia esté lista, Verificamex hace un `POST` a la URL indicada en `webhook` con el PDF. Revisa el formato de ese aviso en [Webhook de constancia CURP](/renapo/curp-pdf-webhook/).

> **Consejo**
>
> Como alternativa al webhook, también puedes hacer *polling*: al consultar el detalle en [Mostrar validación de CURP ante RENAPO](/renapo/show-curp-validation/), el campo `pdf` se llenará automáticamente en cuanto la constancia quede lista.

**status 200 (con PDF)**

> **Nota**
>
> En la respuesta se encuentra el **pdf obtenido** de la persona consultada **en base64**. Esto ocurre cuando no se pidió `pdf_required`, o cuando se pidió y la constancia ya estaba disponible al momento de la consulta.

```json
    {
        "data": {
            "object": "citizeninformations",
            "citizen": {
                "mensaje": "Búsqueda exitosa por curp",
                "codigo": 0,
                "registros": [
                    {
                        "curp": "ABCD950101MDFXYZ09",
                        "nombres": "MARÍA FERNANDA",
                        "primerApellido": "LOPEZ",
                        "segundoApellido": "HERNANDEZ",
                        "sexo": "Mujer",
                        "fechaNacimiento": "1995-01-01",
                        "nacionalidad": "MEX",
                        "entidad": "Ciudad de México",
                        "claveEntidad": "DF",
                        "docProbatorio": 1,
                        "docProbatorioDesc": "Acta de nacimiento",
                        "statusCurp": "RCN",
                        "statusCurpDesc": "Registro de cambio no afectando a CURP",
                        "datosDocProbatorio": {
                            "entidadRegistro": "Ciudad de México",
                            "tomo": 0,
                            "claveMunicipioRegistro": 7,
                            "anioReg": 1995,
                            "claveEntidadRegistro": "",
                            "foja": 0,
                            "numActa": 123,
                            "libro": 0,
                            "municipioRegistro": "",
                            "folioCarta": "",
                            "numEntidadRegistrante": 10,
                            "numRegExtranjeros": ""
                        }
                    }
                ],
                "status": true
            }
            "pdf": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9Db2xvc..."
        },
        "meta": {
            "include": [],
            "custom": []
        },
    }
```

**status 200 (PDF pendiente)**

> **Nota**
>
> Ocurre cuando se envió `pdf_required: true` pero la constancia no estaba disponible de inmediato. El campo `pdf` no viene en la respuesta; llegará después por el `webhook` que hayas indicado (o puedes obtenerla por *polling*, ver arriba).

```json
    {
        "data": {
            "object": "citizeninformations",
            "citizen": {
                "mensaje": "Búsqueda exitosa por curp",
                "codigo": 0,
                "registros": [
                    {
                        "curp": "ABCD950101MDFXYZ09",
                        "nombres": "MARÍA FERNANDA",
                        "primerApellido": "LOPEZ",
                        "segundoApellido": "HERNANDEZ",
                        "sexo": "Mujer",
                        "fechaNacimiento": "1995-01-01",
                        "nacionalidad": "MEX",
                        "entidad": "Ciudad de México",
                        "claveEntidad": "DF",
                        "docProbatorio": 1,
                        "docProbatorioDesc": "Acta de nacimiento",
                        "statusCurp": "RCN",
                        "statusCurpDesc": "Registro de cambio no afectando a CURP",
                        "datosDocProbatorio": {
                            "entidadRegistro": "Ciudad de México",
                            "tomo": 0,
                            "claveMunicipioRegistro": 7,
                            "anioReg": 1995,
                            "claveEntidadRegistro": "",
                            "foja": 0,
                            "numActa": 123,
                            "libro": 0,
                            "municipioRegistro": "",
                            "folioCarta": "",
                            "numEntidadRegistrante": 10,
                            "numRegExtranjeros": ""
                        }
                    }
                ],
                "status": true
            }
        },
        "meta": {
            "include": [],
            "custom": []
        },
    }
```

**status 422**

```json
    {
        "message": "The given data was invalid.",
        "errors": {
            "webhook": ["webhook es obligatorio cuando pdf_required=true."]
        }
    }
```

**status 401**

```json
    {
        "message": "Unauthorized"
    }
```