List trips
Page through the trips stored for your account, most recently ingested first.
Returns the trips SQUAKE stored for you, from every source: API submissions, CSV imports and TMC integrations. Each trip carries its stored attributes and the IDs of its activities. To read the activities themselves, see List the activities of a trip.
Request
GET /v2/travel-data/trips
pageintegerPage number, starting at 1.
itemsintegerTrips per page, from 1 to 100. Defaults to 20.
GET /v2/travel-data/trips in the API referencecurl "https://api.sandbox.squake.earth/v2/travel-data/trips?page=1&items=20" \
--header "Authorization: Bearer $SQUAKE_API_KEY"Response
The body is a JSON array, most recently ingested trip first. An account with no stored trips gets 200 and an empty array.
[
{
"id": "7c9e6f2a-4b81-4d3e-9a52-1f0c8b3d5e47",
"trip_reference": "TRIP-EXAMPLE-002",
"client_id": "4fb3ec7a-92cb-471f-b75f-c3fe7c2a34d5",
"submitted_by_client_id": "4fb3ec7a-92cb-471f-b75f-c3fe7c2a34d5",
"trip_name": "Example business trip to London",
"trip_purpose": "Customer workshop",
"trip_status": "completed",
"booking_provider": "Example TMC",
"start_date_utc": "2026-03-10T00:00:00Z",
"end_date_utc": "2026-03-12T00:00:00Z",
"amount_in_cents": 248500,
"currency": "EUR",
"cost_center": {
"name": "Example Cost Center",
"purpose": "Sales",
"email": "cost-center@example.com"
},
"activity_ids": [
"2b4d6f81-9c3e-4a57-b0d2-6e1f8a4c7b93",
"5e1a9c34-7d62-4f08-b3a1-9c4e2d7f6b58",
"c84f1d27-3e95-4b60-a7d8-2f1b9e6c4a03",
"a1d3b5c7-2e94-4f68-9b0a-7c5d3e1f8a26"
]
}
]A list entry has the same fields as a single trip. A field the source didn't provide reads back as null, and the key is still there. For what each field means, including how SQUAKE maps trip_status, see Trip fields.
Pagination headers
| Header | Meaning |
|---|---|
Current-Page | The page returned. |
Page-Items | Trips per page. |
Total-Pages | Total number of pages. |
Total-Count | Total number of trips. |
Link | RFC 8288 links to the first, prev, next and last pages. |
To read every trip, follow the next link until a response has none.
Accounts that submit for other clients
If submitting on behalf of other clients is enabled for your account, the list holds the trips of the authenticated client and all of its descendants. Read client_id on each trip to see which client owns it. The trips of a parent, a sibling or an unrelated client never appear. See Clients.
Errors
| Status | Meaning |
|---|---|
401 | The API key is missing or invalid. |
Related
- Retrieve a trip
- Delete a trip
- List Travel Data Trips in the API reference