# Quem está chamando

Fonte: https://apiwpp.com/docs/api/conta/quem-esta-chamando
Seção: Conta
Atualizado em: 2026-09-28

`GET /me`

Responde quem é a credencial com que esta requisição se autenticou: o tipo, a organização, os escopos que ela tem e os projetos (tenants) a que está vinculada. É a forma mais simples de conferir uma chave de API nova antes de usá-la. Escopo necessário: `connections:read`.

## Cabeçalhos

| Nome | Obrigatório | Descrição |
| --- | --- | --- |
| `Authorization` | sim | `Bearer <chave de API>`; ou envie a chave em `X-Api-Key`. |

## Exemplo de requisição

### cURL

```bash
curl https://api.apiwpp.com/me \
  -H "Authorization: Bearer $API_KEY"
```

### Node.js

```javascript
const res = await fetch(`https://api.apiwpp.com/me`, {
  headers: {
    Authorization: `Bearer ${API_KEY}`,
  },
})
const data = await res.json()
```

### PHP

```php
$response = Http::withToken($apiKey)
    ->get("https://api.apiwpp.com/me");
```

### Python

```python
import requests

response = requests.get(
    "https://api.apiwpp.com/me",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
```

## Respostas

| Código | Erro | Descrição |
| --- | --- | --- |
| 200 |  | A credencial que chamou: `kind` (`apiKey`, `user` ou `platform`), `user` (o usuário conectado; `null` para uma chave de API), `organization` (a organização em nome de quem a credencial age: a do projeto da chave, ou a organização atual do usuário), `role` (o papel do usuário na organização; `null` para uma chave), `scopes`, `tenantIds` (os projetos a que a chave está vinculada; `null`: todos os projetos da organização) e `apiKey` (`id` e `expiresAt` da chave; `null` fora de uma chave). |
| 401 |  | Sem chave de API, ou com uma chave inválida: desconhecida, revogada, expirada ou de um projeto desativado. O corpo é `{"error": "Unauthorized"}`. |
| 403 |  | A credencial não tem o escopo `connections:read`; a mensagem cita o escopo (`This credential lacks the connections:read scope`). |
| 429 |  | Requisições demais deste IP de origem (por padrão, 600 por minuto), ou autenticações com falha demais (por padrão, 20 a cada 5 minutos; o corpo é `{"error": "Too many failed authentication attempts"}`): espere os segundos de `Retry-After`. Veja [Limites](https://apiwpp.com/docs/referencia/limites). Cabeçalhos: `Retry-After`. |

### 200 OK

```json
{
  "kind": "apiKey",
  "user": null,
  "organization": {
    "id": "2d5e8a1b-4c7f-4e9a-8b3d-6f0a2c4e8b1d",
    "name": "Acme",
    "slug": "acme"
  },
  "role": null,
  "scopes": [
    "connections:read",
    "messages:send"
  ],
  "tenantIds": [
    "3f6c2a8e-9d41-4b7a-8c15-2e7d9a0b4c61"
  ],
  "apiKey": {
    "id": "5e8f1a2b-3c4d-4e5f-8a9b-0c1d2e3f4a5b",
    "expiresAt": null
  }
}
```

## Detalhes

Uma chave de API alcança só os projetos de `tenantIds`: toda chave é vinculada a um único projeto, então a lista traz um só id. `user` e `role` vêm `null`, e `apiKey` traz o `id` da chave e o `expiresAt` dela (`null` quando ela não expira).

Um usuário do painel (`kind: user`, conectado com o cookie de sessão do painel) alcança todos os projetos da organização e das organizações filhas dela, com os escopos do papel do usuário (`owner`, `admin` ou `member`): `tenantIds` e `apiKey` vêm `null`. `kind: platform` é o operador do gateway.

`scopes` lista só os escopos que valem para a credencial: um escopo que uma chave não pode ter não aparece, mesmo que tenha sido gravado nela. Veja [Escopos](https://apiwpp.com/docs/referencia/escopos).

Guia: [Autenticação](https://apiwpp.com/docs/autenticacao).
