Listar cupons

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

string (uuid)

required

string (uuid)

required

Parâmetros de query

string

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

Resposta

200 OK com um array de cupons.

string (uuid)

string

Rótulo de exibição.

string

Código em maiúsculas, usado pelos compradores.

string

FIXED (centavos de BRL) ou PERCENTAGE (0–100).

integer

Valor do desconto. Para FIXED, é em centavos de BRL; para PERCENTAGE, um inteiro de 1 a 100.

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

Status	Quando
`401`	Token ausente ou inválido.

Exemplos

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

import requests

response = requests.get(
    f"https://api.dlpay.cloud/event/seller/{account_id}/events/{event_id}/coupons/",
    headers={"Authorization": f"Bearer {access_token}"},
)
coupons = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/event/seller/${accountId}/events/${eventId}/coupons/`,
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const coupons = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Pré-requisitos

Parâmetros de path

Parâmetros de query

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de path

​Parâmetros de query

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de path

Parâmetros de query

Resposta

Erros

Exemplos