Endpoint: GET /event/event/{event_id}/
Autenticação: Pública (sem auth) Retorna o contexto público de um único evento: nome, descrição, tipo, mídia, configuração de parcelamento, endereço (físico ou digital) e a lista de ingressos disponíveis para venda com disponibilidade em tempo real. É o ponto de entrada que um frontend de checkout público consulta para renderizar a página antes do comprador adquirir os ingressos. Apenas a ação de leitura está disponível — não existe um endpoint público de listagem. Campos sensíveis (vendedor, conta, flags internas) são intencionalmente omitidos.

Pré-requisitos

  • O evento deve existir. O endpoint retorna 400 com {"event": "event not found"} para ids desconhecidos.
  • Os ingressos retornados incluem a propriedade quantity_available, que como efeito colateral expira automaticamente checkouts PENDING com mais de 16 minutos.

Parâmetros de caminho

event_id
string (uuid)
required
Identificador do evento.

Resposta

200 OK com o payload do evento.
id
string (uuid)
name
string
Nome público do evento.
description
string
Descrição completa. Pode conter HTML sanitizado.
type
string
Um dos valores IN_PERSON ou ONLINE.
image_url
string
URL da imagem de capa/banner.
subject
string
Código do assunto (por exemplo, 27 para Música).
category
string
Código da categoria (por exemplo, 39 para Festa, festival ou show).
nomenclature
string
Substantivo exibido na loja: TICKETING (Ingresso), REGISTRATION (Inscrição) ou CONTRIBUTION (Contribuição).
max_installments_no_tax
string
Inteiro 0–12 em formato string. 0 significa que juros são sempre cobrados do comprador (sem parcelas sem juros).
max_installments
string
Inteiro 1–12 em formato string. Limite máximo de parcelas.
starts_at
string
Data e hora de início do evento (ISO-8601).
ends_at
string
Data e hora de término do evento (ISO-8601).
address
object | null
Presente para eventos IN_PERSON. Campos: name, display_map_widget, neighborhood, city, state, postal_code, country_code, street, number, complement.
digital_address
object | null
Presente para eventos ONLINE. Campos: platform (por exemplo, GOOGLE_MEET, ZOOM, YOUTUBE, OTHER), other_platform. A url real da reunião não é retornada no contexto público — só é revelada após a compra.
tickets
array
Ingressos à venda. Cada entrada contém id, name, amount (em centavos de BRL), description, questions (lista de perguntas que o comprador deve responder), sales_period_type (ALWAYS ou PERIOD), sales_starts_at, sales_ends_at e quantity_available.
{
  "id": "1a4e3d12-5b3f-4f0b-9c2c-89d2e1c1d111",
  "name": "Festival Sunset 2026",
  "description": "Edição de aniversário com 20 atrações.",
  "type": "IN_PERSON",
  "image_url": "https://cdn.dlpay.cloud/events/sunset.jpg",
  "subject": "27",
  "category": "39",
  "nomenclature": "TICKETING",
  "max_installments_no_tax": "3",
  "max_installments": "12",
  "starts_at": "2026-08-12T22:00:00Z",
  "ends_at": "2026-08-13T06:00:00Z",
  "address": {
    "name": "Arena Sunset",
    "display_map_widget": true,
    "neighborhood": "Centro",
    "city": "São Paulo",
    "state": "SP",
    "postal_code": "01001-000",
    "country_code": "BR",
    "street": "Av. Paulista",
    "number": "1000",
    "complement": ""
  },
  "digital_address": null,
  "tickets": [
    {
      "id": "9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
      "name": "Pista",
      "amount": 12000,
      "description": "Acesso à área comum.",
      "questions": [],
      "sales_period_type": "ALWAYS",
      "sales_starts_at": null,
      "sales_ends_at": null,
      "quantity_available": 482
    }
  ]
}

Erros

StatusQuando
400O id do evento não existe. Corpo: {"event": "event not found"}.

Exemplos

curl https://api.dlpay.cloud/event/event/1a4e3d12-5b3f-4f0b-9c2c-89d2e1c1d111/