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

# RREE

> Verify a Peruvian foreigner identity card (carné de extranjería) from the RREE: the holder's name, nationality, immigration status and expiration date.

Verifies Peruvian foreigner identity card (carné de extranjería) data from the
Ministerio de Relaciones Exteriores, including name, nationality, immigration
status, and expiration date.

`POST /pe/rree/foreigner-cards/v1`

| Field             | Type   | Notes                                                            |
| ----------------- | ------ | ---------------------------------------------------------------- |
| `document_number` | string | **Required.** The carné de extranjería number. Exactly 8 digits. |

```bash theme={"dark"}
curl https://api.croma.run/pe/rree/foreigner-cards/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "00112233" }'
```

| Field                           | Notes                                                                                |
| ------------------------------- | ------------------------------------------------------------------------------------ |
| `found`                         | `true` when a card matches; `false` when none does (the other fields are then null). |
| `card_number`                   | The carné de extranjería number.                                                     |
| `first_name`, `last_name`       | Given and family names.                                                              |
| `nationality`                   | Nationality.                                                                         |
| `immigration_status`            | Immigration status (calidad migratoria).                                             |
| `birth_date`, `expiration_date` | Birth and card-expiration dates (`yyyy-mm-dd`).                                      |

<Note>
  This lookup can take longer than a typical request. It's an
  [async job](/async-jobs). By default the request
  waits inline and returns `{ data }`, or you can poll / use a `callback_url`.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>