Events

2 endpoints

GET /{account_slug}/events

list events

Returns a paginated list of all events in your account that the API token has access to. Supports filtering by date range, status, and custom field responses.

Requires authentication

Path parameters

Name	Description
`account_slug` string Required	Your Tito account slug

Query parameters

Name	Description
`page` integer	Page number for pagination (default: 1)
`starts_after` string	Events starting on or after this date (e.g. 2025-06-01)
`starts_before` string	Events starting on or before this date (e.g. 2025-12-31)
`status` string	upcoming, current, or past: * `upcoming` * `current` * `past`
`filter[custom_field_slug]` string	Filter by custom field slug (e.g. filter[track]=Frontend)

Response fields

Field	Description
`events` array
`events[].id` integer	Unique internal identifier for the event
`events[].title` string	The display name/title of the event
`events[].slug` string	URL-friendly identifier for the event, used in API endpoints
`events[].description` string \| null	Full description of the event
`events[].starts_at` string \| null	Event start date and time in ISO 8601 format
`events[].ends_at` string \| null	Event end date and time in ISO 8601 format
`events[].time_zone` string \| null	IANA time zone identifier for the event
`events[].location` string \| null	Location description for the event
`events[].tag_line` string \| null	Short tag line for the event (max 80 characters)
`events[].currency` string	Currency code for ticket prices
`events[].sold_out` boolean	Whether all ticket types for this event are sold out
`events[].venue` object \| null	Venue details if a venue has been set
`events[].custom_metadata` object \| null	Custom key-value metadata attached to the event
`events[].custom_data` object	Custom field values for event-level custom fields, keyed by field slug

Error responses

401 – unauthorized - no bearer token provided or token is invalid
403 – forbidden - account slug does not match your API token

Example request

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.pro.tito.io/{account_slug}/events

Example response

{
  "events": [
    {
      "id": 12345,
      "title": "Awesome Conf 2025",
      "slug": "awesome-conf-2025",
      "description": "The best tech conference in Europe",
      "starts_at": "2025-09-15T09:00:00.000Z",
      "ends_at": "2025-09-15T17:00:00.000Z",
      "time_zone": "Europe/Dublin",
      "location": "Dublin, Ireland",
      "tag_line": "Where ideas come alive",
      "currency": "EUR",
      "sold_out": false,
      "venue": {
        "name": "Convention Centre Dublin",
        "address": "Spencer Dock, Dublin 1",
        "lat": 53.3478,
        "lng": -6.2397
      },
      "custom_metadata": {
        "track": "Frontend"
      },
      "custom_data": {
        "track": "Frontend",
        "difficulty": "Intermediate"
      }
    },
    {
      "id": 12346,
      "title": "Workshop Series",
      "slug": "workshop-series",
      "description": null,
      "starts_at": "2025-10-01T10:00:00.000Z",
      "ends_at": "2025-10-01T16:00:00.000Z",
      "time_zone": "America/New_York",
      "location": "New York, NY",
      "tag_line": null,
      "currency": "USD",
      "sold_out": false,
      "venue": null,
      "custom_metadata": null,
      "custom_data": {}
    }
  ]
}

GET /{account_slug}/events/{id}

show event

Returns detailed information about a specific event including dates, location, venue, sold out status, and custom metadata. You can use either the event slug or numeric ID.