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

{
  "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
curl https://api.gatepass.app/api/events

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

Build docs developers (and LLMs) love

Get started for freeTalk to us