Build (lock) a stay fare

Lock a stay fare for purchase. Requires the Mercury fareId (UUID) returned by POST /v1/stays/fares; unknown or expired identifiers return 410 OFFER_EXPIRED. Accepts either an authenticated bearer token or a guest session token. Guest principals run the build through the service-account session's retry-once wrapper; on success the guest's checkout session is stamped with the locked fare id and expiry.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

POST body for /v1/stays/fares/build.

string
required

Fare ID from the fares stream.

Search-solutions ID for lineage context.

SHA-256 solution key for lineage tracking.

boolean
Defaults to false

Booking profile: true for personal travel, false for business travel. Must match the bookingProfile supplied to the preceding POST /v1/stays/search request.

Responses

401

Unauthenticated

404

Fare not found

409

Guest checkout session is past the capture phase

410

Fare expired; refresh fare search

503

Provider unavailable

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