Cada evento possui um ou mais tipos de ingresso. Suporta tipos TICKET, PRODUCT, ADDON, EXPERIENCE e VOUCHER.
/v1/ticket-typesCria um novo tipo de ingresso vinculado a um evento. Preço em centavos (mín R$1,00 = 100).
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| event_id | uuid | OBRIGATÓRIO | ID do evento |
| name | string | OBRIGATÓRIO | Nome (ex: VIP, Pista) |
| price | integer | OBRIGATÓRIO | Preço em centavos |
| total_quantity | integer | OBRIGATÓRIO | Quantidade total |
| type | string | Opcional | TICKET, PRODUCT, ADDON, EXPERIENCE, VOUCHER |
| max_per_order | integer | Opcional | Máx por pedido (0 = ilimitado) |
{
"event_id": "event_uuid",
"name": "Pista",
"description": "Área geral",
"price": 5000,
"total_quantity": 1000,
"type": "TICKET"
}{
"data": {
"id": "tt_uuid",
"name": "Pista",
"price": 5000,
"available_quantity": 1000,
"status": "active"
}
}/v1/ticket-types?event_id=...Lista todos os tipos de ingresso de um evento. Requer auth.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| event_id | uuid | OBRIGATÓRIO | ID do evento |
curl https://api.flair.api.br/api/v1/ticket-types?event_id=event_uuid \ -H "Authorization: Bearer TOKEN"
{
"data": [
{ "id": "tt_uuid", "name": "Pista", "price": 5000, "available_quantity": 847 },
{ "id": "tt_uuid2", "name": "VIP", "price": 15000, "available_quantity": 120 }
]
}/v1/public/events/:id/ticket-typesEndpoint público para o widget/checkout. Retorna tipos disponíveis com info do evento. Não requer auth.
curl https://api.flair.api.br/api/v1/public/events/event_uuid/ticket-types
{
"data": {
"event": {
"id": "...",
"name": "Festival de Verão 2026",
"event_date": "2026-07-15T18:00:00Z"
},
"ticket_types": [
{
"id": "tt_uuid",
"name": "Pista",
"price": 5000,
"available_quantity": 847,
"status": "active"
}
]
}
}/v1/ticket-types/:id/benefitsSubstitui todas as vantagens de um tipo de ingresso. Idempotente — remove as anteriores e cria as novas. Requer auth.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| benefits | string[] | OBRIGATÓRIO | Array com os nomes das vantagens |
curl -X PUT https://api.flair.api.br/api/v1/ticket-types/tt_uuid/benefits \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
-d '{
"benefits": [
"Acesso à Pista Principal",
"Entrada Prioritária",
"Open Bar"
]
}'{
"message": "Benefits updated"
}/v1/ticket-types/:id/benefitsLista todas as vantagens de um tipo de ingresso específico. Requer auth.
curl https://api.flair.api.br/api/v1/ticket-types/tt_uuid/benefits \ -H "Authorization: Bearer TOKEN"
{
"data": [
{
"id": "ben_uuid",
"ticket_type_id": "tt_uuid",
"name": "Acesso à Pista Principal",
"sort_order": 0
},
{
"id": "ben_uuid2",
"ticket_type_id": "tt_uuid",
"name": "Entrada Prioritária",
"sort_order": 1
}
]
}/v1/public/events/:id/benefitsRetorna todas as vantagens de todos os tipos de ingresso de um evento. Não requer auth. Usado para montar a tabela comparativa na página pública do evento.
curl https://api.flair.api.br/api/v1/public/events/event_uuid/benefits
{
"data": [
{
"id": "ben_uuid",
"ticket_type_id": "tt_uuid",
"name": "Acesso à Pista Principal",
"sort_order": 0
},
{
"id": "ben_uuid2",
"ticket_type_id": "tt_uuid",
"name": "Entrada Prioritária",
"sort_order": 1
},
{
"id": "ben_uuid3",
"ticket_type_id": "tt_vip_uuid",
"name": "Acesso à Pista Principal",
"sort_order": 0
},
{
"id": "ben_uuid4",
"ticket_type_id": "tt_vip_uuid",
"name": "Open Bar",
"sort_order": 1
}
]
}Nossa infraestrutura global processa milhões de requisições simultâneas em horários de pico. Junte-se a +500 promotores usando Flair.
Uptime Garantido