# Listar projetos

Fonte: https://apiwpp.com/docs/api/projetos/listar-projetos
Seção: Projetos
Atualizado em: 2026-09-28

`GET /tenants`

Lista os projetos que a credencial alcança, do mais recente ao mais antigo, com o plano da organização e o número de conexões de cada um. Uma chave de API pertence a um único projeto, então a lista traz só ele. 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/tenants \
  -H "Authorization: Bearer $API_KEY"
```

### Node.js

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

### PHP

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

### Python

```python
import requests

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

## Respostas

| Código | Erro | Descrição |
| --- | --- | --- |
| 200 |  | Os projetos em `tenants`, do mais recente ao mais antigo, cada um com `plan` e `connectionCount`, e o total em `count`. |
| 401 |  | Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. A chave de um projeto desativado também responde `401`. |
| 403 |  | A chave não tem o escopo `connections:read`; a mensagem de erro cita o escopo que falta. |
| 429 |  | Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de `Retry-After`. Veja [Limites](https://apiwpp.com/docs/referencia/limites). Cabeçalhos: `Retry-After`. |

### 200 OK

```json
{
  "tenants": [
    {
      "id": "3f6c2a8e-9d41-4b7a-8c15-2e7d9a0b4c61",
      "organizationId": "2d5e8a1b-4c7f-4e9a-8b3d-6f0a2c4e8b1d",
      "name": "acme-crm",
      "webhookBaseUrl": "https://crm.example.com/api/whatsapp/events",
      "webhookHeaderNames": [
        "X-Crm-Account"
      ],
      "emitOutgoing": true,
      "maxPerMinute": null,
      "maxPerHour": null,
      "maxPerDay": null,
      "hasWebhookSecret": true,
      "planId": "b7e2c9d4-1f3a-4c5b-8d6e-9f0a1b2c3d4e",
      "subscriptionStatus": "active",
      "trialEndsAt": null,
      "currentPeriodEnd": "2026-10-24T12:00:00.000Z",
      "isActive": true,
      "createdAt": "2026-09-01T12:00:00.000Z",
      "updatedAt": "2026-09-24T12:00:00.000Z",
      "plan": {
        "id": "b7e2c9d4-1f3a-4c5b-8d6e-9f0a1b2c3d4e",
        "name": "pro",
        "displayName": "Pro",
        "maxConnections": 5,
        "maxMessagesDay": 1000,
        "maxMessagesMonth": 20000,
        "monthlyPriceCents": 9900
      },
      "connectionCount": 1
    }
  ],
  "count": 1
}
```

## Detalhes

O plano e a assinatura são da organização, não do projeto: `planId`, `subscriptionStatus`, `trialEndsAt` e `currentPeriodEnd` são os da organização dona, e `plan` traz os limites do plano (`maxConnections`, `maxMessagesDay`, `maxMessagesMonth`, em que `-1` é ilimitado) e o preço mensal em centavos (`monthlyPriceCents`, em que `-1` é preço sob consulta).

As credenciais do webhook nunca voltam nas respostas: `hasWebhookSecret` diz se há um segredo de assinatura, e `webhookHeaderNames` traz só os nomes dos cabeçalhos personalizados. `maxPerMinute`, `maxPerHour` e `maxPerDay` são limites de envio próprios de cada número do projeto, definidos pela plataforma; `null` usa os limites padrão do gateway.

Guia: [Projetos e conexões](https://apiwpp.com/docs/guias/projetos-e-conexoes).
