API Reference
  1. Mercury API
  2. Bookings

Cancel a booking

post
https://example.com/v1//bookings//cancel

Cancel a confirmed booking (flights, stays, cars, trains; others return 503). estimatedTotalAmount should be sourced from a preceding POST /v1/{vertical}/bookings/{id}/calculate-cancel-costs call when the vertical supports it.

The Idempotency-Key header is required.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required
Allowed:
string
required
Body Params

Request body for cancelling a booking.

estimatedTotalAmount must be obtained from a preceding
POST /v1/{vertical}/bookings/{id}/calculate-cancel-costs call so
the cancellation cost can be verified. The value is a decimal string
(e.g. "125.50") to preserve precision.

string
required

Decimal string from the preceding calculate-cancel-costs response, e.g. '125.50'. Required to verify cancellation cost integrity.

Headers

Client-generated idempotency key (UUID v4 recommended). Required on all booking mutation requests to prevent duplicate bookings on retry.

Responses

401

Missing or invalid authentication

403

User lacks booking capability for this vertical

404

Booking not found

409

Booking already in a terminal state

410

Offer expired (OFFER_EXPIRED); refresh fare search

422

Missing Idempotency-Key header, or account requires mandatory custom attributes that were not supplied

503

Service not configured or temporarily unavailable

Updated 4 months ago

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

Updated 4 months ago

Did this page help you?