/tours

List tours by latestStart. A status or updatedSince filter is applied while filling each page, so a page can be short or empty and still carry a cursor. Tours written before updatedAtMilliseconds existed never match updatedSince.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum

Return only tours with this status.

Allowed:
integer
≥ 1

Return only tours updated at or after this instant, in epoch milliseconds. Requires both from and to. Tours written before updatedAtMilliseconds existed never match.

number

The earliest start date of the tours to retrieve as epoch timestamp.

number

The latest start date of the tours to retrieve as epoch timestamp.

string
enum

Sorting direction for tours. Tours are always sorted by start date.

Allowed:
string

Filter tours to instances generated from a specific recurring-master draft (descending by start date by default — set sorted=ascending to flip). For the draft-centric chronological drilldown use GET /drafts/{id}/instances, which always returns ascending and validates the draft is a recurring master.

string

Opaque pagination cursor — pass the cursors.after value from the previous response to retrieve the next page.

number
Defaults to 500

Maximum count of items in one page.

Responses

400

bad request

401

unauthorized

403

The role of the API key does not allow this action. The key needs a role with the matching permission, for example full access.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json