Endpoints

Endpoint:
/Events

A Events API permite listar, criar e gerenciar eventos de ticketing na rede Flair. Integrada com inventário em tempo real e precificação dinâmica.

Última AtualizaçãoMAR 2026

POST/v1/events

Criar evento

Cria um novo evento. Requer autenticação Bearer. O evento é criado com status 'active' por padrão.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
name	string	OBRIGATÓRIO	Nome do evento (max 255 chars)
description	string	Opcional	Descrição do evento
location	string	Opcional	Local do evento
event_date	iso8601	OBRIGATÓRIO	Data/hora (deve ser no futuro)
max_capacity	integer	Opcional	Capacidade máxima
allow_transfers	boolean	Opcional	Permitir transferência (default: true)
transfer_deadline	integer	Opcional	Horas antes do evento para deadline (default: 24)
max_transfers	integer	Opcional	Máx transferências por ingresso (default: 3)
transfer_fee	integer	Opcional	Taxa de transferência em centavos (default: 0)

curl -X POST https://api.flair.api.br/api/v1/events \
  -H "Authorization: Bearer FLAIR_TOKEN" \
  -d '{
    "name": "Festival de Verão 2026",
    "description": "O maior festival do Brasil",
    "location": "Parque Ibirapuera, SP",
    "event_date": "2026-07-15T18:00:00Z",
    "max_capacity": 5000
  }'

Resposta

201 Created

{
  "data": {
    "id": "event_uuid",
    "name": "Festival de Verão 2026",
    "status": "active",
    "event_date": "2026-07-15T18:00:00Z",
    "location": "Parque Ibirapuera, SP",
    "max_capacity": 5000
  }
}

GET/v1/events

Listar eventos

Retorna a lista de eventos da sua organização em ordem cronológica reversa. Suporta filtros por status e busca textual.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
status	string	Opcional	Filtrar por status (active, cancelled)
search	string	Opcional	Busca por nome
limit	integer	Opcional	Limite de resultados (default: 10)

curl https://api.flair.api.br/api/v1/events?status=active&search=festival \
  -H "Authorization: Bearer FLAIR_TOKEN"

Resposta

200 OK

{
  "data": [
    {
      "id": "event_uuid",
      "name": "Festival de Verão 2026",
      "status": "active",
      "event_date": "2026-07-15T18:00:00Z"
    }
  ]
}

GET/v1/events/:id

Obter evento

Retorna os detalhes completos de um evento específico, incluindo estatísticas de vendas.

curl https://api.flair.api.br/api/v1/events/event_uuid \
  -H "Authorization: Bearer FLAIR_TOKEN"

Resposta

200 OK

{
  "data": {
    "id": "event_uuid",
    "name": "Festival de Verão 2026",
    "status": "active",
    "event_date": "2026-07-15T18:00:00Z",
    "location": "Parque Ibirapuera, SP",
    "max_capacity": 5000,
    "tickets_sold": 1247
  }
}

PUT/v1/events/:id

Atualizar evento

Atualiza campos de um evento existente. Apenas campos enviados são modificados.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
name	string	Opcional	Novo nome
location	string	Opcional	Novo local
description	string	Opcional	Nova descrição

curl -X PUT https://api.flair.api.br/api/v1/events/event_uuid \
  -H "Authorization: Bearer FLAIR_TOKEN" \
  -d '{ "name": "Novo Nome", "location": "Novo Local" }'

Resposta

200 OK

{
  "data": {
    "id": "event_uuid",
    "name": "Novo Nome",
    "location": "Novo Local"
  }
}

POST/v1/events/:id/cancel

Cancelar evento

Cancela um evento. Todos os ingressos são reembolsados automaticamente e compradores notificados por email.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
reason	string	OBRIGATÓRIO	Motivo do cancelamento

Ação irreversível. Todos os ingressos vendidos serão reembolsados automaticamente.

curl -X POST https://api.flair.api.br/api/v1/events/event_uuid/cancel \
  -H "Authorization: Bearer FLAIR_TOKEN" \
  -d '{ "reason": "Condições climáticas adversas" }'

Resposta

200 OK

{
  "data": {
    "id": "event_uuid",
    "status": "cancelled",
    "refunds_processed": 1247
  }
}

DELETE/v1/events/:id

Deletar evento

Remove permanentemente um evento. Só é possível deletar eventos sem vendas.

Só eventos sem ingressos vendidos podem ser deletados.

curl -X DELETE https://api.flair.api.br/api/v1/events/event_uuid \
  -H "Authorization: Bearer FLAIR_TOKEN"

Resposta

200 OK

{ "message": "Event deleted" }

Pronto para escalar?

Nossa infraestrutura global processa milhões de requisições simultâneas em horários de pico. Junte-se a +500 promotores usando Flair.

99.9%

Uptime Garantido

API

terminalAPI Sandbox

api.flair.api.br

Headers