> ## 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

> Verifique os dados do carné de extranjería peruano.

Verifica os dados do carné de extranjería peruano do
Ministério das Relações Exteriores, incluindo nome, nacionalidade, status
migratório e data de vencimento.

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

| Campo             | Tipo   | Notas                                                                    |
| ----------------- | ------ | ------------------------------------------------------------------------ |
| `document_number` | string | **Obrigatório.** O número do carné de extranjería. Exatamente 8 dígitos. |

```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" }'
```

| Campo                           | Notas                                                                                                         |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `found`                         | `true` quando um carné corresponde; `false` quando nenhum corresponde (os demais campos ficam então em null). |
| `card_number`                   | O número do carné de extranjería.                                                                             |
| `first_name`, `last_name`       | Nomes e sobrenomes.                                                                                           |
| `nationality`                   | Nacionalidade.                                                                                                |
| `immigration_status`            | Calidad migratoria.                                                                                           |
| `birth_date`, `expiration_date` | Datas de nascimento e de vencimento do carné (`yyyy-mm-dd`).                                                  |

<Note>
  Esta consulta pode demorar mais que uma solicitação típica. É um
  [trabalho assíncrono](/pt/async-jobs). Por padrão, a solicitação
  espera de forma síncrona e retorna `{ data }`, ou você pode fazer polling / usar um `callback_url`.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>