Endpoint: GET /event/seller/{account_id}/events/{events_pk}/coupons/
Autenticação: JWT obrigatório ou Chave de API aceita.
Lista todos os cupons de desconto definidos para o evento, ordenados por -created_at. Os códigos são únicos dentro de cada evento e sempre armazenados em letras maiúsculas.

Pré-requisitos

  • O evento precisa existir sob {account_id}.

Parâmetros de path

account_id
string (uuid)
required
events_pk
string (uuid)
required

Parâmetros de query

Busca textual (contém, sem diferenciação de maiúsculas/minúsculas) em name ou code.

Resposta

200 OK com um array de cupons.
id
string (uuid)
name
string
Rótulo de exibição.
code
string
Código em maiúsculas, usado pelos compradores.
type
string
FIXED (centavos de BRL) ou PERCENTAGE (0–100).
value
integer
Valor do desconto. Para FIXED, é em centavos de BRL; para PERCENTAGE, um inteiro de 1 a 100.
created_at
string
updated_at
string
[
  {
    "id": "ccccdddd-eeee-ffff-0000-111122223333",
    "name": "Lançamento 10%",
    "code": "SUNSET10",
    "type": "PERCENTAGE",
    "value": 10,
    "created_at": "2026-05-01T12:00:00Z",
    "updated_at": "2026-05-01T12:00:00Z"
  }
]

Erros

StatusQuando
401Token ausente ou inválido.

Exemplos

curl "https://api.dlpay.cloud/event/seller/$ACCOUNT_ID/events/$EVENT_ID/coupons/" \
  -H "Authorization: Bearer $ACCESS_TOKEN"