Events
2 endpoints
/{account_slug}/events
list events
Returns a paginated list of all events in your account that the API token has access to. Each event includes basic information such as title and slug.
Requires authentication
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
account_slug |
path | string | Yes | The unique slug identifier for your Tito account |
page |
query | integer | No | Page number for pagination (default: 1) |
Response fields
| Field | Type | 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 |
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.staging.pro.tito.io/{account_slug}/events
Example response
{
"events": [
{
"id": 123456,
"title": "My Conference 2025",
"slug": "my-conference-2025"
},
{
"id": 123457,
"title": "Workshop Series",
"slug": "workshop-series"
}
]
}
/{account_slug}/events/{id}
show event
Returns detailed information about a specific event. Use this to retrieve event metadata and configuration. You can use either the event slug or numeric ID.
Requires authentication
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
account_slug |
path | string | Yes | The unique slug identifier for your Tito account |
id |
path | string | Yes | The unique slug identifier for the event (can also use numeric ID) |
Response fields
| Field | Type | Description |
|---|---|---|
id |
integer | Unique internal identifier for the event |
title |
string | The display name/title of the event |
Error responses
- 401 – unauthorized - no bearer token provided or token is invalid
- 404 – not found - event slug does not exist or is not accessible
Example request
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
https://api.staging.pro.tito.io/{account_slug}/events/123
Example response
{
"id": 123456,
"title": "My Conference 2025"
}