List Events

Retrieve a list of public events with optional filters

GET /api/events

cURL - All Events

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

200 OK

{
  "events": [
    {
      "id": "clx1234567890abcdef",
      "title": "Tech Conference 2026",
      "source": "gatepass",
      "eventDate": "2026-06-15T09:00:00.000Z",
      "venue": "San Francisco Convention Center",
      "city": "San Francisco",
      "country": "USA",
      "latitude": 37.7842,
      "longitude": -122.4016,
      "imageUrl": "https://example.com/event-image.jpg",
      "price": 99,
      "distanceKm": 2.3,
      "tiers": [
        {
          "id": "tier_early_bird",
          "name": "Early Bird",
          "description": "Limited time discount tickets",
          "price": 99,
          "available": 100,
          "saleStart": "2026-03-06T12:00:00.000Z",
          "saleEnd": "2026-06-15T18:00:00.000Z"
        },
        {
          "id": "tier_general",
          "name": "General Admission",
          "description": "Standard conference access",
          "price": 149,
          "available": 500,
          "saleStart": "2026-03-06T12:00:00.000Z",
          "saleEnd": "2026-06-15T18:00:00.000Z"
        },
        {
          "id": "tier_vip",
          "name": "VIP",
          "description": "VIP access with exclusive workshops",
          "price": 299,
          "available": 50,
          "saleStart": "2026-03-06T12:00:00.000Z",
          "saleEnd": "2026-06-15T18:00:00.000Z"
        }
      ]
    },
    {
      "id": "clx9876543210fedcba",
      "title": "Summer Music Festival",
      "source": "gatepass",
      "eventDate": "2026-07-20T14:00:00.000Z",
      "venue": "Golden Gate Park",
      "city": "San Francisco",
      "country": "USA",
      "latitude": 37.7694,
      "longitude": -122.4862,
      "imageUrl": "https://example.com/festival.jpg",
      "price": 75,
      "distanceKm": 5.1,
      "tiers": [
        {
          "id": "tier_ga",
          "name": "General Admission",
          "description": "Standard festival access",
          "price": 75,
          "available": 1000,
          "saleStart": "2026-03-01T00:00:00.000Z",
          "saleEnd": "2026-07-20T14:00:00.000Z"
        }
      ]
    }
  ]
}

Query Parameters

q · string

Search query to match against title, description, city, or venue

category · string

Filter by event category (CONFERENCE, MUSIC, WORKSHOP, MEETUP, FESTIVAL, SPORTS, THEATER, OTHER)

lat · number

Latitude for location-based filtering. Must be used with lng and optionally radiusKm

lng · number

Longitude for location-based filtering. Must be used with lat and optionally radiusKm

radiusKm · number

Search radius in kilometers. Default: 50. Requires lat and lng

minPrice · number

Minimum ticket price filter (inclusive)

maxPrice · number

Maximum ticket price filter (inclusive)

startDate · string

Filter events occurring on or after this date (ISO 8601 format)

endDate · string

Filter events occurring on or before this date (ISO 8601 format)

Response

events · array

Array of event objects

Show Event Object

id · string

Unique event identifier

title · string

Event title

source · string

Event source (gatepass or ticketmaster)

eventDate · string

Event date and time

venue · string

Venue name

city · string

City name

country · string

Country name

latitude · number

Venue latitude coordinate

longitude · number

Venue longitude coordinate

imageUrl · string

Event image URL

price · number

Lowest available ticket price

distanceKm · number

Distance from search location in kilometers (only included when lat/lng provided)

tiers · array

Array of ticket tier objects

Show Tier Object

id · string

Tier identifier

name · string

Tier name

description · string

Tier description

price · number

Tier price

available · number

Available quantity

saleStart · string

Sale start date/time

saleEnd · string

Sale end date/time

cURL - All Events

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

200 OK

{
  "events": [
    {
      "id": "clx1234567890abcdef",
      "title": "Tech Conference 2026",
      "source": "gatepass",
      "eventDate": "2026-06-15T09:00:00.000Z",
      "venue": "San Francisco Convention Center",
      "city": "San Francisco",
      "country": "USA",
      "latitude": 37.7842,
      "longitude": -122.4016,
      "imageUrl": "https://example.com/event-image.jpg",
      "price": 99,
      "distanceKm": 2.3,
      "tiers": [
        {
          "id": "tier_early_bird",
          "name": "Early Bird",
          "description": "Limited time discount tickets",
          "price": 99,
          "available": 100,
          "saleStart": "2026-03-06T12:00:00.000Z",
          "saleEnd": "2026-06-15T18:00:00.000Z"
        },
        {
          "id": "tier_general",
          "name": "General Admission",
          "description": "Standard conference access",
          "price": 149,
          "available": 500,
          "saleStart": "2026-03-06T12:00:00.000Z",
          "saleEnd": "2026-06-15T18:00:00.000Z"
        },
        {
          "id": "tier_vip",
          "name": "VIP",
          "description": "VIP access with exclusive workshops",
          "price": 299,
          "available": 50,
          "saleStart": "2026-03-06T12:00:00.000Z",
          "saleEnd": "2026-06-15T18:00:00.000Z"
        }
      ]
    },
    {
      "id": "clx9876543210fedcba",
      "title": "Summer Music Festival",
      "source": "gatepass",
      "eventDate": "2026-07-20T14:00:00.000Z",
      "venue": "Golden Gate Park",
      "city": "San Francisco",
      "country": "USA",
      "latitude": 37.7694,
      "longitude": -122.4862,
      "imageUrl": "https://example.com/festival.jpg",
      "price": 75,
      "distanceKm": 5.1,
      "tiers": [
        {
          "id": "tier_ga",
          "name": "General Admission",
          "description": "Standard festival access",
          "price": 75,
          "available": 1000,
          "saleStart": "2026-03-01T00:00:00.000Z",
          "saleEnd": "2026-07-20T14:00:00.000Z"
        }
      ]
    }
  ]
}

This endpoint combines events from the GatePass database, file storage, and external sources (Ticketmaster). Results are deduplicated by title and event date, and sorted by distance when location parameters are provided.