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

# GET /v1/me

> Valida a API key e retorna a organização dona dela

Retorna a organização autenticada e os metadados da API key usada na chamada. É o endpoint ideal para testar credenciais e para descobrir programaticamente a qual organização uma chave pertence.

```text theme={null}
GET https://api.iuzypay.com/v1/me
```

## Requisição

Nenhum parâmetro. Requer [autenticação](/api/autenticacao) por API key.

```bash theme={null}
curl https://api.iuzypay.com/v1/me \
  -H "Authorization: Bearer $IUZYPAY_API_KEY"
```

## Resposta

`200 OK`

```json theme={null}
{
  "organization": {
    "id": "6f1c9d2e-8a4b-4c3d-9e2f-1a2b3c4d5e6f",
    "name": "Minha Empresa"
  },
  "api_key": {
    "id": "0b7e4a1c-2d3e-4f5a-8b9c-0d1e2f3a4b5c",
    "prefix": "iuzy_sk_AbCd"
  }
}
```

<ResponseField name="organization.id" type="string (UUID)">
  Identificador da organização dona da chave.
</ResponseField>

<ResponseField name="organization.name" type="string">
  Nome da organização, como exibido no dashboard.
</ResponseField>

<ResponseField name="api_key.id" type="string (UUID)">
  Identificador da chave usada na chamada — o mesmo listado em **Configurações → API keys**.
</ResponseField>

<ResponseField name="api_key.prefix" type="string">
  Prefixo público da chave, útil para identificar qual chave foi usada sem expor o valor completo.
</ResponseField>

## Erros

`401 unauthorized` — chave ausente, malformada ou revogada. Veja [Autenticação](/api/autenticacao#erros-de-autenticacao).