List a colleague's eligible travel documents for a train fare

Return the stored travel documents of a colleague in the caller's own account that are eligible for this locked fare. Call it after locking the fare and before booking for the colleague.

A document is eligible when its type is accepted by the fare (an empty or absent accepted-types list accepts every type), it has an issue date, and it does not expire before the last arriving leg of the itinerary. Only masked metadata and an opaque selectionToken are returned — never the full document number, images, or internal ids.

  • documentRequired: false — the fare needs no document; no stored document is looked up and none should be sent at booking.
  • One item — booking create uses it automatically.
  • Several items — send the chosen selectionToken as passengers[].colleagueDocumentToken at booking create.
  • No items — send a complete inline passengers[].document.

A complete inline document always takes precedence over a stored document or token and is used only for this booking. The token stays valid while the locked fare is live and may be reused after a failed booking attempt; a token that no longer matches an eligible document is rejected at booking create with 409.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Query Params
uuid
required
Responses

401

Missing or invalid authentication

403

User lacks booking capability, or the provider denied

410

Fare has expired (refresh search)

422

colleagueId is not a colleague in the caller's account

502

Upstream returned a malformed colleague record

503

Colleague or travel document service unavailable

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