Partner Trips API
Let your booking suppliers start travelmode trip plans for their travel groups — and keep your marketplace in sync with what the group plans.
The Partner Trips API is the B2B surface for third-party marketplaces:
- Organizations and suppliers. Your marketplace is a travelmode
organization with a stable
organization_id. You register each of your group providers as a supplier under it, keyed by your ownexternal_id— used for attribution, filtering, and reporting. - Start trip planning. One call creates a trip shell linked to your organization and returns a claim link for the group organizer plus the planner URL where the group continues in travelmode's UI — including the AI planning assistant.
- Ownership via claim. The organizer opens the claim link, signs in, and the trip becomes theirs in their own travelmode account. Your organization keeps API access to the trip before and after the claim.
- Description sync, both directions. Pull the partner trip view
(name, description, summary, status, public story URL, a
revisioncounter) anytime, or subscribe to signedtrip.updated/trip.claimedwebhooks on the shared platform webhook pipeline.
Endpoints at a glance
| Area | Endpoints |
|---|---|
| Organization | GET /v1/partner/organization (whoami) |
| Suppliers | POST/GET /v1/partner/suppliers, GET/PATCH/DELETE /v1/partner/suppliers/[supplierId] |
| Trips | POST/GET /v1/partner/trips, GET/PATCH /v1/partner/trips/[tripId] |
| Claim | POST /v1/partner/trips/[tripId]/claim-token (re-issue) |
| Webhooks | shared platform API: POST /v1/webhooks with trip.* events |
Start with Getting Started, then read The Claim Flow and Description Sync and Webhooks.
Authentication
Every request sends your organization key as
Authorization: Bearer tm_trips_.... Keys carry trips:* scopes and
are issued by the Travelmode team when your organization is registered.
See Authentication and Scopes.