Get Event

Retrieve detailed information about a specific event

GET /api/events/:id

cURL

curl https://api.gatepass.app/api/events/clx1234567890abcdef

200 OK

{
  "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

Show Tier Object

id · string

Tier identifier

name · string

Tier name

description · string

Tier description and benefits

price · number

Ticket price for this tier

availableQuantity · number

Number of tickets available

maxPerPerson · number

Maximum tickets per person for this tier

saleStart · string

Tier sale start date/time

saleEnd · string

Tier sale end date/time

eventId · string

Associated event ID

createdAt · string

Tier creation timestamp

updatedAt · string

Tier last update timestamp

cURL

curl https://api.gatepass.app/api/events/clx1234567890abcdef

200 OK

{
  "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"
    }
  ]
}