> ## Documentation Index
> Fetch the complete documentation index at: https://developers.verifica.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Extranjeros

> Valida los datos de un extranjero consultando su número de documento

## Autenticación

Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de [Autenticación](/api-reference/authentication)):

```
Authorization: Bearer YOUR_API_KEY
```

## Atributos Requeridos

<ParamField body="document_number" type="string" required>
  Número de documento, Carnet de Extranjería, a validar
</ParamField>

<ParamField body="birthdate" type="string" required>
  Fecha de nacimiento del titular del documento a validar
</ParamField>

## Respuesta

<ResponseField name="type" type="string">
  Tipo de respuesta (ej: "result")
</ResponseField>

<ResponseField name="status" type="integer">
  Código de estado HTTP de la respuesta (ej: 200)
</ResponseField>

<ResponseField name="message" type="string">
  Mensaje descriptivo del resultado de la validación
</ResponseField>

<ResponseField name="data" type="object">
  Datos del extranjero validado

  <Expandable title="propiedades de data">
    <ResponseField name="numero_de_documento" type="string">
      Número de documento consultado
    </ResponseField>

    <ResponseField name="calidad_migratoria" type="string">
      Calidad migratoria del titular (ej: "ESPECIAL")
    </ResponseField>

    <ResponseField name="nombres" type="string">
      Nombres del titular
    </ResponseField>

    <ResponseField name="nacionalidad" type="string">
      Nacionalidad del titular
    </ResponseField>

    <ResponseField name="apellido_paterno" type="string">
      Apellido paterno
    </ResponseField>

    <ResponseField name="apellido_materno" type="string">
      Apellido materno
    </ResponseField>

    <ResponseField name="fecha_nacimiento" type="string">
      Fecha de nacimiento (formato YYYY-MM-DD)
    </ResponseField>

    <ResponseField name="fecha_expiracion_residencia" type="string">
      Fecha de expiración de la residencia (formato YYYY-MM-DD)
    </ResponseField>

    <ResponseField name="fecha_expiracion_carnet" type="string">
      Fecha de expiración del carnet (formato YYYY-MM-DD)
    </ResponseField>

    <ResponseField name="fecha_ultima_emision_carnet" type="string">
      Fecha de la última emisión del carnet (formato YYYY-MM-DD)
    </ResponseField>
  </Expandable>
</ResponseField>

## Ejemplo de Solicitud

```bash theme={null}
curl https://api.verifica.id/v2/consulta/extranjeros \
  -H "Authorization: Bearer {TU-API-KEY}" \
  -d document_number=003278330 \
  -d birthdate=1990-01-31
```

## Ejemplo de Respuesta Exitosa

```json theme={null}
{
  "type": "result",
  "status": 200,
  "message": "Se ha validado la información correctamente.",
  "data": {
    "numero_de_documento": "012093887",
    "calidad_migratoria": "ESPECIAL",
    "nombres": "MIGUEL ADRIANO",
    "nacionalidad": "VENEZOLANA",
    "apellido_paterno": "CUBAS",
    "apellido_materno": "QUEVEDO",
    "fecha_nacimiento": "1990-01-31",
    "fecha_expiracion_residencia": "2026-01-30",
    "fecha_expiracion_carnet": "2026-01-24",
    "fecha_ultima_emision_carnet": "2023-02-02"
  }
}
```

## Códigos de Error

| Código | Descripción                                                                                                   |
| ------ | ------------------------------------------------------------------------------------------------------------- |
| 400    | Solicitud inválida - los campos `document_number` y `birthdate` son requeridos o tienen un formato incorrecto |
| 401    | Token de autenticación inválido o faltante                                                                    |
| 429    | Demasiadas solicitudes - se ha excedido el límite de rate                                                     |
| 500    | Error interno del servidor                                                                                    |