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

pageinteger

Page number, starting at 1.

itemsinteger

Trips per page, from 1 to 100. Defaults to 20.

See every field of GET /v2/travel-data/trips in the API reference
curl "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.

200 OKapplication/json
[
  {
    "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

HeaderMeaning
Current-PageThe page returned.
Page-ItemsTrips per page.
Total-PagesTotal number of pages.
Total-CountTotal number of trips.
LinkRFC 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

StatusMeaning
401The API key is missing or invalid.

On this page

GET/v2/travel-data/trips

Run this request against the sandbox with your test key.

Open in API reference