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
selectionTokenaspassengers[].colleagueDocumentTokenat 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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401Missing or invalid authentication
403User lacks booking capability, or the provider denied
410Fare has expired (refresh search)
422colleagueId is not a colleague in the caller's account
502Upstream returned a malformed colleague record
503Colleague or travel document service unavailable