Ingresso

Um ingresso, com o que a lista traz e o restante.

GET

/v1/event/{id}/ticket/{ticketId}

Além das informações básicas, vêm as respostas que o titular preencheu e os addons. Se o evento ou o ingresso não existe, ou a chave não pode ver o evento, a API devolve 404.

LGPD

Esta rota devolve nome, e-mail, CPF e telefone. Quem consome a API responde pelo armazenamento e pelo uso desses dados.

Requer a permissão

TICKETS_READ

Path

Campo	Tipo	Descrição
id	string	Id do evento.
ticketId	string	Id do ingresso.

Campos

Campo	Tipo	Descrição
_id	string	Id do ingresso. Também valida na porta.
externalCode	string \| null	Pulseira, NFC ou código externo.
name	string	Nome do titular.
email	string	E-mail do usuário vinculado ou o e-mail pendente no ingresso.
taxID	string?	CPF/CNPJ do titular, só dígitos. Omitido se vazio.
phone	string?	Telefone do titular. Omitido se vazio.
status	TICKET_STATUS_ENUM	Status do ingresso.
tierId	string	Id do lote. Igual a sections[].tiers[]._id.
tierName	string \| null	Nome do lote. Nulo se o lote não está mais no evento.
sectionId	string \| null	Id da seção desse lote. O ingresso guarda tierId; a seção vem do lote. Nulo se o lote não está mais no evento.
tierSectionName	string \| null	Nome da seção do lote. Nulo se a seção não está mais no evento.
tierOptionId	string \| null	Id da opção do lote, se houver. Nulo quando não há opção.
tierOptionLabel	string \| null	Label da opção do lote, se houver. Nulo quando não há opção.
couponId	string \| null	Cupom usado nesta compra. Mesmo id de coupons[]._id no evento. Nulo quando não houve cupom.
couponCode	string \| null	Código desse cupom, como PROMO10. Nulo quando não houve cupom, ou o cupom não está mais no evento.
confirmedAt	ISO-8601 \| null	Quando o ingresso foi validado na porta. Nulo até lá.
confirmedBy	string \| null	Quem validou o ingresso. Nulo até lá.
createdAt	ISO-8601	Quando o ingresso foi criado.

customFields[]

Campo	Tipo	Descrição
eventCustomFieldId	string	Id do campo customizado do evento.
label	string	Label do campo.
value	string	Valor preenchido pelo titular.

addons[]

Campo	Tipo	Descrição
_id	string	Id do addon emitido.
addonId	string	Id do addon no catálogo do evento.
name	string	Nome do addon.
status	ACTIVE \| CONFIRMED	Status de validação do addon.

cURL

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

Resposta

{
  "success": true,
  "data": {
    "_id": "665f0c2a1c9d44009abcdef0",
    "externalCode": null,
    "name": "Maria Silva",
    "email": "[email protected]",
    "taxID": "12345678901",
    "phone": "+5511988887777",
    "status": "ACTIVE",
    "tierId": "665f0c2a1c9d4400aaaaaaaa",
    "tierName": "Pista",
    "sectionId": "665f0c2a1c9d4400cccccccc",
    "tierSectionName": "Geral",
    "tierOptionId": null,
    "tierOptionLabel": null,
    "couponId": "665f0c2a1c9d4400000000cc",
    "couponCode": "PROMO10",
    "confirmedAt": "2026-10-10T23:10:00.000Z",
    "confirmedBy": "Portaria",
    "createdAt": "2026-10-01T15:00:00.000Z",
    "customFields": [
      {
        "eventCustomFieldId": "665f0c2a1c9d440000000001",
        "label": "Tamanho da camiseta",
        "value": "M"
      }
    ],
    "addons": [
      {
        "_id": "665f0c2a1c9d4400000000aa",
        "addonId": "665f0c2a1c9d4400000000ab",
        "name": "Abadá",
        "status": "ACTIVE"
      }
    ]
  }
}