Listar Todos os Cupons
Descrição
Retorna uma lista paginada de cupons cadastrados no sistema, ordenados pela data de criação. Suporta filtros por código, status e período de datas. Retorna 12 registros por página por padrão. Este endpoint pode ser utilizado para exibição ou administração de campanhas promocionais.
Verbo
GET
URL Base
https://api.soargi.com
Endpoint
/coupons?page=1&limit=12&code=&status=active&start_date=&end_date=
Cabeçalhos
| Parâmetro | Valor |
|---|---|
| Authorization | Bearer Token |
Parâmetros de Consulta
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| page | integer | Não | Número da página. Padrão: 1. |
| limit | integer | Não | Quantidade de registros por página. Padrão: 12. |
| code | string | Não | Busca por código do cupom. |
| status | string | Não | Filtrar por status do cupom. Valores: "active", "expired". |
| start_date | date | Não | Filtrar cupons válidos a partir desta data (formato: YYYY-MM-DD). |
| end_date | date | Não | Filtrar cupons válidos até esta data (formato: YYYY-MM-DD). |
Sucesso - 200
{
"success": true,
"message": "Coupons retrieved successfully.",
"page": 1,
"limit": 12,
"total": 18,
"data": [
{
"coupon_id": "3",
"code": "SOAR20",
"discount": "20",
"status": "active",
"start_date": "2024-11-15",
"end_date": "2025-11-15",
"start_time": "07:30:00",
"end_time": "19:30:00",
"timezone": "GMT+00:00",
"usages": "5",
"enable_users": "0",
"created_at": "2025-05-08 16:18:47",
"updated_at": "2025-05-08 16:18:47",
"list_users": [4,7,8]
},
{
"coupon_id": "2",
"code": "SOAR15",
"discount": "15",
"status": "expired",
"start_date": "2023-01-01",
"end_date": "2024-01-01",
"start_time": "09:00:00",
"end_time": "20:00:00",
"timezone": "GMT-05:00",
"usages": "10",
"enable_users": "1",
"created_at": "2025-05-08 16:18:37",
"updated_at": "2025-05-08 16:18:37",
"list_users": [2,7]
},
{
"coupon_id": "1",
"code": "SOAR10",
"discount": "10",
"status": "active",
"start_date": "2024-10-01",
"end_date": "2025-10-01",
"start_time": "08:00:00",
"end_time": "18:00:00",
"timezone": "GMT-03:00",
"usages": "0",
"enable_users": "0",
"created_at": "2025-05-08 16:18:24",
"updated_at": "2025-05-08 16:18:24",
"list_users": [4,7,8,9,15]
}
]
}
Códigos de Resposta
- 200 - Lista de cupons retornada com sucesso
Observações
- É necessário estar autenticado para acessar este endpoint.
- A paginação padrão retorna 12 registros por página.
- Todos os filtros (code, status, start_date, end_date) podem ser combinados.
- Os cupons são ordenados por data de criação (mais recentes primeiro).
- O campo list_users contém IDs dos usuários autorizados a usar o cupom.
- O campo usages mostra quantas vezes o cupom foi utilizado.
- Datas devem estar no formato YYYY-MM-DD (ex: 2025-10-01).