# Listar ofertas de um plano

URL: https://staging.pagpolar.com/docs/referencia/planos/list-plan-offers

> `id` precisa ser o id (uuid) de um plano da sua conta — planos de outro whitelabel retornam 404.

`GET /plans/{id}/offers`

## Autenticação

- Token Bearer no header `Authorization` (esquema `BearerAuth`). Token de acesso devolvido por POST /auth/token. Envie como "Authorization: Bearer <token>". Vale 24 horas.

## Parâmetros de caminho

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | texto (uuid) | sim | Exemplo: `a8b9c0d1-e2f3-4a4b-5c6d-7e8f9a0b1c2d`. |

## Parâmetros de consulta

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `page` | inteiro | não | Número da página, começando em 1. |
| `per_page` | inteiro | não | Itens por página, de 1 a 100. |
| `is_active` | booleano | não | `true` lista só os ativos; `false`, só os inativos. Sem o filtro, lista os dois. |
| `title` | texto | não | Título da oferta. Busca por parte do texto, sem diferenciar maiúsculas de minúsculas. |

## Respostas

### 200 — Lista de ofertas do plano

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `data` | [lista de Oferta](/docs/referencia/entidades/oferta) | não | — |
| `meta` | objeto | não | — |
| `meta.page` | inteiro | não | Exemplo: `1`. |
| `meta.per_page` | inteiro | não | Exemplo: `25`. |
| `meta.total` | inteiro | não | Exemplo: `143`. |
| `meta.total_pages` | inteiro | não | Exemplo: `6`. |

## Erros

| Status | Descrição |
| --- | --- |
| `401` | Token ausente, inválido ou expirado, ou credencial revogada ou expirada. Chame POST /auth/token para obter um token novo. |
| `403` | IP não autorizado |
| `404` | Plano não encontrado |
| `429` | Limite de requisições excedido |

Lista completa de códigos e como tratá-los: [Erros](/docs/guias/fundamentos/erros).