G
GlobalEventBase
Event API

List events

Retrieve a list of events filtered by country, category, and paginated options.

GET
/api/events

Query Parameters

country?string

ISO2 country code (e.g., US, CA, UK). Defaults to US.

Default"US"
category?string

Filter by event category (e.g., concert, sports, tech).

page?integer

Page number for pagination.

Default1
Range1 <= value
size?integer

Number of items per page. Max 100.

Default20
Range1 <= value <= 100

Response Body

application/json

curl -X GET "https://globaleventbase.com/api/events"
{
  "page": 0,
  "size": 0,
  "total": 0,
  "items": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "start_date": "2019-08-24T14:15:22Z",
      "end_date": "2019-08-24T14:15:22Z",
      "location": {
        "city": "string",
        "country": "string",
        "venue": "string",
        "coordinates": {
          "lat": 0,
          "lng": 0
        }
      },
      "categories": [
        "string"
      ],
      "raw_payload": {}
    }
  ]
}