Listar eventos

Devolve os eventos da produtora, uma página por vez.

GET

/v1/events

Use para alimentar site, CRM ou planilha. Cada página traz 15 eventos. Se a chave estiver limitada a alguns eventos, só esses voltam. Quando existe outra página, nextPage é esse número. Na última, é nulo.

Requer a permissão

EVENTS_READ

Query

Campo	Tipo	Descrição
page	string	Página. Default 1. Tamanho fixo de 15 itens.
search	string	Busca por título, url ou _id.
isPast	true \| false	true = eventos já encerrados. false = ainda não encerrados. Omitido = todos.

Campos

Campo	Tipo	Descrição
_id	string	Id do evento.
title	string	Título.
description	string	Descrição.
place	string	Local.
address	object \| null	Endereço público: fullAddress, zipcode, street, number, neighborhood, city, state, complement, country, location.
startAt	ISO-8601	Início do evento.
endAt	ISO-8601	Fim do evento.
url	string	Slug público.
flyers	string[]	URLs dos flyers.
type	EVENT_TYPE_ENUM	Hoje: PARTY.
genres	EVENT_GENRE_ENUM[]	Gêneros.
attractions	string[]	Atrações.
classification	number \| null	Classificação etária.
isPrivate	boolean	Se o evento é privado.

cURL

curl -sS https://open-api.hub.nittio.com.br/v1/events \
  -H "Authorization: Bearer sk_ntt_live_<keyId>_<secret>"

Resposta

{
  "success": true,
  "data": [
    {
      "_id": "665f0c2a1c9d440012345678",
      "title": "Festa Exemplo",
      "description": "...",
      "place": "Casa Nittio",
      "address": {
        "fullAddress": "Rua Exemplo, 100",
        "city": "São Paulo",
        "state": "SP"
      },
      "startAt": "2026-10-10T22:00:00.000Z",
      "endAt": "2026-10-11T06:00:00.000Z",
      "url": "festa-exemplo",
      "flyers": ["https://cdn.nittio.com.br/flyer.jpg"],
      "type": "PARTY",
      "genres": ["ELECTRONIC"],
      "attractions": ["DJ Exemplo"],
      "classification": 18,
      "isPrivate": false
    },
    {
      "_id": "665f0c2a1c9d440087654321",
      "title": "After no Terraço",
      "description": "...",
      "place": "Terraço Nittio",
      "address": {
        "fullAddress": "Av. Atlântica, 200",
        "city": "Rio de Janeiro",
        "state": "RJ"
      },
      "startAt": "2026-10-17T23:00:00.000Z",
      "endAt": "2026-10-18T07:00:00.000Z",
      "url": "after-no-terraco",
      "flyers": ["https://cdn.nittio.com.br/after.jpg"],
      "type": "PARTY",
      "genres": ["HOUSE"],
      "attractions": ["DJ Terraço"],
      "classification": 18,
      "isPrivate": false
    }
  ],
  "nextPage": null
}