Partner Reports

Ingressos, combos e produtos

O catálogo do evento na granularidade de lote. Sem parâmetros, os três endpoints retornam a lista completa; /tickets e /bundles também aceitam filtros de data e paginação por cursor.

Listar ingressos do evento

GET/v1/reports/organizations/{organizationId}/events/{eventId}/tickets

Lista completa dos tipos de ingresso na granularidade de lote — um item por lote de cada ingresso. Sem parâmetros, retorna a lista completa (array puro); aceita leitura incremental — veja abaixo.

Campo	Tipo	Descrição
`id`	string (UUID)	Identificador do lote.
`dates[]`	array	Sessões associadas ao grupo do ingresso.
`group_id`	string	Identificador do setor.
`group_name`	string	Nome do setor — ex.: Pista, Camarote.
`ticket_id`	string	Identificador do tipo de ingresso.
`ticket_name`	string	Nome do tipo de ingresso.
`ticket_tier_id`	string	Identificador do lote.
`ticket_tier_name`	string	Nome do lote — ex.: 1º Lote.
`price`	integer	Preço de catálogo em centavos.
`creation_ticket`	string	Data de criação.
`updated_ticket`	string	Data da última atualização.
`begin_sales`	string	Início do período de vendas do lote.
`end_sales`	string	Fim do período de vendas do lote.
`status`	string	Status do ingresso/lote.
`max_stock`	integer	Estoque máximo configurado — base para “emitidos” no borderô.

Combos

GET/v1/reports/organizations/{organizationId}/events/{eventId}/bundles

Combos na granularidade de lote. Sem parâmetros, retorna a lista completa; aceita leitura incremental — veja abaixo. Campos idênticos a /tickets, trocando o prefixo: bundle_id, bundle_name, bundle_tier_id, bundle_tier_name, creation_combo, updated_combo, mais bundle_type (tipo do combo, ex.: fixed). Em combos, begin_sales é a primeira venda registrada.

Produtos

GET/v1/reports/organizations/{organizationId}/events/{eventId}/products

Produtos do evento — um item por produto, sem lote. Não paginado. Campos: id, dates[], product_id, product_name, price, creation_combo, updated_combo, begin_sales, end_sales, status, max_stock.

Timestamps sem timezone

creation_ticket, updated_ticket, begin_sales, end_sales e as datas de combo vêm no horário local do evento, sem indicação de fuso. Não os converta assumindo UTC.

Leitura incremental (/tickets e /bundles)

/tickets e /bundles aceitam os mesmos parâmetros opcionais de /orders: updated_after, updated_before, created_after, created_before (janela de data, limites inclusivos), limit (liga o modo cursor — default 20, teto 200) e cursor (retoma a travessia). Sem limit/cursor, a resposta continua sendo o array JSON puro; em modo cursor ela muda para o envelope { items, next_cursor, has_more }. Misturar formatos inválidos ou limit ≤ 0 → 400. /products não aceita esses parâmetros.

Fuso dos filtros — diferente de /orders

Aqui os valores de janela sem offset são interpretados como UTC (e offset explícito é aceito) — em /orders, são interpretados no horário local do evento e offset é recusado com 400. A diferença vem do schema das colunas na origem. O guia completo de leitura incremental (formatos, watermark, margem de sobreposição) está na página de Pedidos.