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_id

Headers obrigatórios

ParâmetroTipoDescrição
AuthorizationObrigatório
Bearer {token}Token de acesso OAuth.

Parâmetros de URL

ParâmetroTipoDescriçã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

StatusDescrição
200OKEvento retornado com sucesso.
400Bad Requestevent_id ausente ou fora do formato UUID.
401UnauthorizedToken ausente ou inválido.
403ForbiddenSem permissão para o evento.
404Not FoundEvento inexistente ou ainda não sincronizado com a Access Control.
429Too Many RequestsRate limit excedido (Retry-After).
500Internal Server ErrorErro interno do serviço.
502Bad GatewayDependê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)

CampoTipoDescriçã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
stringNome do evento.
slug
stringSlug do evento na Ingresse.
type
stringsingle (uma sessão) | multi (várias sessões).
banner_image_url
stringURL do banner. Ausente quando não há.
map_image_url
stringURL do mapa do local. Ausente quando não há.
timezone
string (IANA)Fuso horário do evento, ex.: America/Sao_Paulo.
status
stringdraft | 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
objectLocal do evento (abaixo). Ausente quando não há.
organization
objectOrganização dona do evento (abaixo). Ausente quando não há.
provider
objectProvedor de biometria configurado (abaixo). Ausente quando o evento não usa biometria.
total_tickets
intTotal de ingressos do evento.
event_dates
arraySessões do evento (abaixo). Sempre presente; [] quando não há.
groups
arrayGrupos de ingressos (abaixo). Sempre presente; [] quando não há ou quando a consulta falhar.

data.place

CampoTipoDescrição
id
string (UUID)Identificador interno do local.
external_id
stringIdentificador do local na Ingresse.
name
stringNome do local.
latitude
numberLatitude.
longitude
numberLongitude.

data.organization

CampoTipoDescrição
id
string (UUID)Identificador interno da organização.
external_id
stringIdentificador da organização na Ingresse.
name
stringNome da organização.
created_at
string (RFC3339)Data de criação.
updated_at
string (RFC3339)Data da última atualização.

data.provider

CampoTipoDescrição
id
string (UUID)Identificador interno do provedor.
name
stringNome de exibição do provedor.
provider
stringChave do provedor, ex.: facepass.
url
stringURL base do provedor.
alias
stringApelido curto. Ausente quando não há.
arguments
objectParâ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.
CampoTipoDescriçã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
stringData e hora da sessão, no formato acima.
past
booleantrue 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.

CampoTipoDescriçã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
stringNome do grupo (setor).
event_dates
arraySessões em que o grupo vale, no mesmo formato de event_dates. Sempre presente; [] quando não há.
tickets
arrayTipos de ingresso do grupo (abaixo). Sempre presente; [] quando não há.

data.groups[].tickets[]

CampoTipoDescriçã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
stringNome do tipo de ingresso.