Tours

Tours are the top-level grouping for a collection of events.

Resource overview

GET/api/toursAPI key · Session

POST/api/toursAPI key · Session

GET/api/tours/{id}API key · Session

PATCH/api/tours/{id}API key · Session

DELETE/api/tours/{id}API key · Session

List tours

GET/api/toursAPI key · Session

Name	Type	Required	Description
`page`	`integer`	Optional	Page number. Default: `1`
`limit`	`integer`	Optional	Page size. Default: `10`
`status`	`string`	Optional	Filter by tour status.

200

{
  "data": [
    {
      "id": "tour-uuid",
      "name": "Summer 2026",
      "startDate": "2026-06-01T00:00:00Z",
      "endDate": "2026-08-31T00:00:00Z",
      "status": "active",
      "_count": { "events": 12 }
    }
  ],
  "total": 4,
  "page": 1,
  "limit": 10,
  "totalPages": 1
}

Create tour

POST/api/toursAPI key · Session

Name	Type	Required	Description
`name`	`string`	Required	Tour name.
`startDate`	`string (ISO 8601)`	Required	Start date.
`endDate`	`string (ISO 8601)`	Required	End date. Must be after startDate.
`description`	`string`	Optional	Free-form description.

Get tour

GET/api/tours/{id}API key · Session

Returns the tour with embedded events[].

Update tour