Access Control API
Event API
Recupera os dados de um evento com suas sessões e grupos de ingressos. É a rota para descobrir os UUIDs de sessão (data.event_dates[].external_id) usados pela Guest List e pela Validation.
GET
/v1/events/:event_idHeaders obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
AuthorizationObrigatório | Bearer {token} | Token de acesso OAuth. |
Parâmetros de URL
| Parâmetro | Tipo | Descrição |
|---|---|---|
event_idObrigatório | string (UUID) | UUID do evento na Ingresse — o mesmo usado nas rotas de Guest List e Validation. Na resposta ele volta em external_id. |
Exemplo de requisição
cURL · GET
curl -X GET \
"https://<ACCESS_CONTROL_PROD_HOST>/v1/events/:event_id" \
-H "Accept: application/json" \
-H "Authorization: Bearer {token}"Respostas
| Status | Descrição |
|---|---|
| 200OK | Evento retornado com sucesso. |
| 400Bad Request | event_id ausente ou fora do formato UUID. |
| 401Unauthorized | Token ausente ou inválido. |
| 403Forbidden | Sem permissão para o evento. |
| 404Not Found | Evento inexistente ou ainda não sincronizado com a Access Control. |
| 429Too Many Requests | Rate limit excedido (Retry-After). |
| 500Internal Server Error | Erro interno do serviço. |
| 502Bad Gateway | Dependência upstream indisponível. |
Exemplo de resposta
JSON
{
"data": {
"id": "a1b2c3d4-0000-4000-8000-000000000001",
"external_id": "88888888-8888-4888-8888-888888888888",
"name": "Music Festival 2026",
"slug": "music-festival-2026",
"type": "multi",
"banner_image_url": "https://cdn.exemplo.com/banner.jpg",
"map_image_url": "https://cdn.exemplo.com/map.jpg",
"timezone": "America/Sao_Paulo",
"status": "published",
"place_id": "a1b2c3d4-0000-4000-8000-000000000002",
"organization_id": "a1b2c3d4-0000-4000-8000-000000000003",
"place": {
"id": "a1b2c3d4-0000-4000-8000-000000000002",
"external_id": "ext-place-111",
"name": "Allianz Parque",
"latitude": -23.527,
"longitude": -46.678
},
"organization": {
"id": "a1b2c3d4-0000-4000-8000-000000000003",
"external_id": "ext-org-222",
"name": "Produtora Exemplo",
"created_at": "2025-11-24T10:00:00Z",
"updated_at": "2025-11-24T15:30:00Z"
},
"total_tickets": 1500,
"event_dates": [
{
"id": "a1b2c3d4-0000-4000-8000-000000000010",
"external_id": "55555555-5555-4555-8555-555555555555",
"event_id": "a1b2c3d4-0000-4000-8000-000000000001",
"date": "2026-12-25 20:00:00",
"past": false
},
{
"id": "a1b2c3d4-0000-4000-8000-000000000011",
"external_id": "66666666-6666-4666-8666-666666666666",
"event_id": "a1b2c3d4-0000-4000-8000-000000000001",
"date": "2026-12-26 20:00:00",
"past": false
}
],
"groups": [
{
"id": "a1b2c3d4-0000-4000-8000-000000000020",
"external_id": "44444444-4444-4444-8444-444444444444",
"name": "Pista",
"event_dates": [
{
"id": "a1b2c3d4-0000-4000-8000-000000000010",
"external_id": "55555555-5555-4555-8555-555555555555",
"event_id": "a1b2c3d4-0000-4000-8000-000000000001",
"date": "2026-12-25 20:00:00",
"past": false
}
],
"tickets": [
{
"id": "a1b2c3d4-0000-4000-8000-000000000030",
"external_id": "22222222-2222-4222-8222-222222222222",
"name": "Pista - Inteira"
},
{
"id": "a1b2c3d4-0000-4000-8000-000000000031",
"external_id": "22222222-2222-4222-8222-222222222223",
"name": "Pista - Meia"
}
]
}
]
}
}Envelope
Como na Guest List, o evento vem dentro da chave data. Os corpos de erro seguem a mesma convenção da Guest List.
Grupos indisponíveis
Se a consulta de grupos falhar, a rota ainda devolve 200 com o evento e groups vazio ([]). Trate groups vazio como indisponível quando o evento tiver ingressos (total_tickets > 0) e retente.
Campos de resposta
Ambientes
Para alternar entre ambientes, troque apenas o host: use
<ACCESS_CONTROL_PROD_HOST> em produção (fornecido junto com suas credenciais) e apigw-access-control.dev.ingresse.com em desenvolvimento.id × external_id
Em todos os objetos, id é o identificador interno da Access Control e external_id é o identificador da Ingresse. Nas URLs desta API (:event_id, :session_id) e nos filtros da Guest List (ticket_id, group_id) use sempre o external_id.
data (evento)
| Campo | Tipo | Descrição |
|---|---|---|
id | string (UUID) | Identificador interno do evento na Access Control. |
external_id | string (UUID) | UUID do evento na Ingresse (o mesmo de :event_id). |
name | string | Nome do evento. |
slug | string | Slug do evento na Ingresse. |
type | string | single (uma sessão) | multi (várias sessões). |
banner_image_url | string | URL do banner. Ausente quando não há. |
map_image_url | string | URL do mapa do local. Ausente quando não há. |
timezone | string (IANA) | Fuso horário do evento, ex.: America/Sao_Paulo. |
status | string | draft | published | finished | suspended |
place_id | string (UUID) | Identificador interno do local. Ausente quando não há. |
organization_id | string (UUID) | Identificador interno da organização. Ausente quando não há. |
provider_id | string (UUID) | Identificador interno do provedor de biometria. Ausente quando o evento não usa biometria. |
place | object | Local do evento (abaixo). Ausente quando não há. |
organization | object | Organização dona do evento (abaixo). Ausente quando não há. |
provider | object | Provedor de biometria configurado (abaixo). Ausente quando o evento não usa biometria. |
total_tickets | int | Total de ingressos do evento. |
event_dates | array | Sessões do evento (abaixo). Sempre presente; [] quando não há. |
groups | array | Grupos de ingressos (abaixo). Sempre presente; [] quando não há ou quando a consulta falhar. |
data.place
| Campo | Tipo | Descrição |
|---|---|---|
id | string (UUID) | Identificador interno do local. |
external_id | string | Identificador do local na Ingresse. |
name | string | Nome do local. |
latitude | number | Latitude. |
longitude | number | Longitude. |
data.organization
| Campo | Tipo | Descrição |
|---|---|---|
id | string (UUID) | Identificador interno da organização. |
external_id | string | Identificador da organização na Ingresse. |
name | string | Nome da organização. |
created_at | string (RFC3339) | Data de criação. |
updated_at | string (RFC3339) | Data da última atualização. |
data.provider
| Campo | Tipo | Descrição |
|---|---|---|
id | string (UUID) | Identificador interno do provedor. |
name | string | Nome de exibição do provedor. |
provider | string | Chave do provedor, ex.: facepass. |
url | string | URL base do provedor. |
alias | string | Apelido curto. Ausente quando não há. |
arguments | object | Parâmetros públicos do provedor (ex.: URL de cadastro). Ausente quando não há. |
data.event_dates[] · data.groups[].event_dates[]
Formato da data
date vem como "YYYY-MM-DD HH:MM:SS", sem offset e sem o T do RFC 3339, tanto no evento quanto dentro dos grupos. É o mesmo valor que a Guest List devolve em ticket.group.event_dates[].date (lá com T e Z): interprete como UTC e use timezone para exibir no horário local do evento.
| Campo | Tipo | Descrição |
|---|---|---|
id | string (UUID) | Identificador interno da sessão. |
external_id | string (UUID) | UUID da sessão na Ingresse. É o :session_id das rotas de Guest List e Validation. |
event_id | string (UUID) | Identificador interno do evento (o id da raiz). |
date | string | Data e hora da sessão, no formato acima. |
past | boolean | true quando a sessão já passou, calculado no momento da requisição. |
data.groups[]
Cada grupo é um setor/categoria de ingressos. Suas sessões (event_dates) dizem em quais sessões do evento os ingressos daquele grupo valem; seus ingressos (tickets) são os tipos vendidos no grupo.
| Campo | Tipo | Descrição |
|---|---|---|
id | string (UUID) | Identificador interno do grupo. |
external_id | string (UUID) | UUID do grupo na Ingresse. Use no filtro group_id da Guest List. |
name | string | Nome do grupo (setor). |
event_dates | array | Sessões em que o grupo vale, no mesmo formato de event_dates. Sempre presente; [] quando não há. |
tickets | array | Tipos de ingresso do grupo (abaixo). Sempre presente; [] quando não há. |
data.groups[].tickets[]
| Campo | Tipo | Descrição |
|---|---|---|
id | string (UUID) | Identificador interno do tipo de ingresso. |
external_id | string (UUID) | UUID do ingresso na Ingresse. Use no filtro ticket_id da Guest List. |
name | string | Nome do tipo de ingresso. |
