> ## 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 Peruvian foreigner identity card data.

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). |

<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, response fields, and an interactive playground.
</Card>