Skip to main content
GET
/
api
/
events
/
:id
curl https://api.gatepass.app/api/events/clx1234567890abcdef

{
  "id": "clx1234567890abcdef",
  "title": "Tech Conference 2026",
  "description": "Annual technology conference featuring industry leaders",
  "venue": "San Francisco Convention Center",
  "address": "747 Howard St",
  "city": "San Francisco",
  "country": "USA",
  "latitude": 37.7842,
  "longitude": -122.4016,
  "source": "gatepass",
  "externalUrl": null,
  "eventDate": "2026-06-15T09:00:00.000Z",
  "saleStart": "2026-03-06T12:00:00.000Z",
  "saleEnd": "2026-06-15T18:00:00.000Z",
  "totalSupply": 650,
  "ticketPrice": 99,
  "currency": "USD",
  "maxPerWallet": 5,
  "contractAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "chainId": 137,
  "imageUrl": "https://example.com/event-image.jpg",
  "metadataUri": "ipfs://QmX...",
  "category": "CONFERENCE",
  "tags": "technology,conference,networking",
  "isPublic": true,
  "allowTransfers": true,
  "requireKYC": false,
  "status": "PUBLISHED",
  "organizerId": "clx0987654321fedcba",
  "createdAt": "2026-03-06T12:00:00.000Z",
  "updatedAt": "2026-03-06T12:00:00.000Z",
  "tiers": [
    {
      "id": "tier_early_bird_001",
      "name": "Early Bird",
      "description": "Limited time discount tickets",
      "price": 99,
      "availableQuantity": 100,
      "maxPerPerson": 2,
      "saleStart": "2026-03-06T12:00:00.000Z",
      "saleEnd": "2026-06-15T18:00:00.000Z",
      "eventId": "clx1234567890abcdef",
      "createdAt": "2026-03-06T12:00:00.000Z",
      "updatedAt": "2026-03-06T12:00:00.000Z"
    },
    {
      "id": "tier_general_002",
      "name": "General Admission",
      "description": "Standard conference access",
      "price": 149,
      "availableQuantity": 500,
      "maxPerPerson": 5,
      "saleStart": "2026-03-06T12:00:00.000Z",
      "saleEnd": "2026-06-15T18:00:00.000Z",
      "eventId": "clx1234567890abcdef",
      "createdAt": "2026-03-06T12:00:00.000Z",
      "updatedAt": "2026-03-06T12:00:00.000Z"
    },
    {
      "id": "tier_vip_003",
      "name": "VIP",
      "description": "VIP access with exclusive workshops",
      "price": 299,
      "availableQuantity": 50,
      "maxPerPerson": 3,
      "saleStart": "2026-03-06T12:00:00.000Z",
      "saleEnd": "2026-06-15T18:00:00.000Z",
      "eventId": "clx1234567890abcdef",
      "createdAt": "2026-03-06T12:00:00.000Z",
      "updatedAt": "2026-03-06T12:00:00.000Z"
    }
  ]
}

​
Path Parameters

​
id
string
required
The unique identifier of the event

​
Response

​
id
string
Unique event identifier
​
title
string
Event title
​
description
string
Detailed event description
​
venue
string
Venue name
​
address
string
Full street address
​
city
string
City name
​
country
string
Country name
​
latitude
number
Venue latitude coordinate
​
longitude
number
Venue longitude coordinate
​
source
string
Event source (gatepass, ticketmaster, etc.)
​
externalUrl
string
External event URL if applicable
​
eventDate
string
Event start date and time
​
saleStart
string
Ticket sale start date/time
​
saleEnd
string
Ticket sale end date/time
​
totalSupply
number
Total ticket capacity
​
ticketPrice
number
Base or minimum ticket price
​
currency
string
Currency code (USD, ETH, etc.)
​
maxPerWallet
number
Maximum tickets per wallet/user
​
contractAddress
string
Blockchain contract address for NFT tickets
​
chainId
number
Blockchain chain ID (e.g., 137 for Polygon)
​
imageUrl
string
Event image URL
​
metadataUri
string
IPFS or HTTP URL to ticket metadata
​
category
string
Event category (CONFERENCE, MUSIC, WORKSHOP, MEETUP, FESTIVAL, SPORTS, THEATER, OTHER)
​
tags
string
Comma-separated tags
​
isPublic
boolean
Whether the event is publicly visible
​
allowTransfers
boolean
Whether ticket transfers are allowed
​
requireKYC
boolean
Whether KYC is required for ticket purchase
​
status
string
Event status (PUBLISHED, DRAFT, CANCELLED)
​
organizerId
string
ID of the event organizer
​
createdAt
string
Event creation timestamp
​
updatedAt
string
Last update timestamp
​
tiers
array
Array of ticket tier objects
curl https://api.gatepass.app/api/events/clx1234567890abcdef

{
  "id": "clx1234567890abcdef",
  "title": "Tech Conference 2026",
  "description": "Annual technology conference featuring industry leaders",
  "venue": "San Francisco Convention Center",
  "address": "747 Howard St",
  "city": "San Francisco",
  "country": "USA",
  "latitude": 37.7842,
  "longitude": -122.4016,
  "source": "gatepass",
  "externalUrl": null,
  "eventDate": "2026-06-15T09:00:00.000Z",
  "saleStart": "2026-03-06T12:00:00.000Z",
  "saleEnd": "2026-06-15T18:00:00.000Z",
  "totalSupply": 650,
  "ticketPrice": 99,
  "currency": "USD",
  "maxPerWallet": 5,
  "contractAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "chainId": 137,
  "imageUrl": "https://example.com/event-image.jpg",
  "metadataUri": "ipfs://QmX...",
  "category": "CONFERENCE",
  "tags": "technology,conference,networking",
  "isPublic": true,
  "allowTransfers": true,
  "requireKYC": false,
  "status": "PUBLISHED",
  "organizerId": "clx0987654321fedcba",
  "createdAt": "2026-03-06T12:00:00.000Z",
  "updatedAt": "2026-03-06T12:00:00.000Z",
  "tiers": [
    {
      "id": "tier_early_bird_001",
      "name": "Early Bird",
      "description": "Limited time discount tickets",
      "price": 99,
      "availableQuantity": 100,
      "maxPerPerson": 2,
      "saleStart": "2026-03-06T12:00:00.000Z",
      "saleEnd": "2026-06-15T18:00:00.000Z",
      "eventId": "clx1234567890abcdef",
      "createdAt": "2026-03-06T12:00:00.000Z",
      "updatedAt": "2026-03-06T12:00:00.000Z"
    },
    {
      "id": "tier_general_002",
      "name": "General Admission",
      "description": "Standard conference access",
      "price": 149,
      "availableQuantity": 500,
      "maxPerPerson": 5,
      "saleStart": "2026-03-06T12:00:00.000Z",
      "saleEnd": "2026-06-15T18:00:00.000Z",
      "eventId": "clx1234567890abcdef",
      "createdAt": "2026-03-06T12:00:00.000Z",
      "updatedAt": "2026-03-06T12:00:00.000Z"
    },
    {
      "id": "tier_vip_003",
      "name": "VIP",
      "description": "VIP access with exclusive workshops",
      "price": 299,
      "availableQuantity": 50,
      "maxPerPerson": 3,
      "saleStart": "2026-03-06T12:00:00.000Z",
      "saleEnd": "2026-06-15T18:00:00.000Z",
      "eventId": "clx1234567890abcdef",
      "createdAt": "2026-03-06T12:00:00.000Z",
      "updatedAt": "2026-03-06T12:00:00.000Z"
    }
  ]
}

Build docs developers (and LLMs) love

Get started for freeTalk to us