Build (lock) a car fare

Lock and return a fully-priced car fare. Confirms the price with the provider before booking. Requires the Mercury fareId (UUID) returned by POST /v1/cars/fares; unknown or expired identifiers return 410 OFFER_EXPIRED. The returned fare is valid for a limited time window. 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/cars/fares/build.

string
required
length ≥ 1

Mercury UUID for the fare (the fareId field emitted by POST /v1/cars/fares).

Mercury UUID for the search solution (optional lineage context).

SHA-256 solution key for lineage tracking.

Responses

401

Missing or invalid authentication

404

Fare not found

409

Guest checkout session is past the capture phase

410

Fare expired; refresh fare search

422

Invalid fare parameters

503

Car fare provider unavailable

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