Trips

List trips

GET/api/v1/tripsScope trips:read

Every trip of the agency, oldest change first, paged by cursor. To sync, keep the updated_at of the last trip you read and pass it as updated_since next time.

Query parameters

statuscomma-separated listoptional

Comma-separated list of statuses, for example planning,confirmed. Omit it to get every status.

proposalplanningconfirmedactivecompleteddeclinedcancelled

updated_sincetimestampoptional

Only trips changed at or after this instant. ISO 8601, for example 2026-09-26T00:00:00Z.

starts_afterdateoptional

Only trips starting on or after this day. YYYY-MM-DD. Trips without dates are left out.

starts_beforedateoptional

Only trips starting on or before this day. YYYY-MM-DD. Trips without dates are left out.

limitintegeroptionalDefault 50

How many objects per page, from 1 to 200.

cursorstringoptional

The next_cursor from the previous page. Keep the other parameters the same while you follow it: changing a filter changes the result set and can skip objects.

Returns

A list of Trip objects.

object"list"

dataarray of Trip

next_cursorstring or null

Pass as cursor for the next page. Null on the last page.

Errors

401unauthorizedNo key, a malformed one, or a key that does not exist or was revoked. Send it as Authorization: Bearer <key>.

403api_not_enabledRoundPlan has not turned on API access for this agency.

403subscription_inactiveThe agency's trial expired or its subscription ended.

403insufficient_scopeThe key cannot read this. An owner adds trips:read to a key in Settings → API.

400invalid_requestA query parameter is not valid. The message says which.

429rate_limitedToo many requests. Wait the seconds in Retry-After. See Errors and rate limits.

500internal_errorSomething went wrong on our side. Retry later.