Cancel a held booking

Cancel a held (unpaid) reservation. The reservation is deleted at the supplier and the PNR is released.

Permission: Read+Write. Rate group: booking (1,200 requests per minute per key).

Why cancel a hold

If you create a hold and abandon it, the airline can refuse a new booking for the same passenger on the same route while the old reservation is pending. Cancel the old hold to release the PNR before you book that passenger again.

Identifying the order

Send one: the first one present wins, in this order, and another one that holds a different value is dropped with an ignored_field warning. PNRs are not unique across suppliers: prefer order_id. Legacy names: orderId, bookingId.

Conditions

The call is refused unless all of these hold:

• the booking belongs to your agency (another agency's booking is answered like an unknown one);
• the supplier is Amadeus Algeria or Travelport (a Duffel order is answered with 400: Duffel has no holds);
• the booking status is awaiting_payment (a confirmed or already cancelled booking is 409 invalid_booking_status).

Request example

curl https://api.fx-port.com/api/v1/flights/cancel_order \
  -H "Authorization: Bearer fxp_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "order_id": "eJzTd9ePNA90dHUGAAsuAlA"
}'

Response example

Real response of 2026-11-01 for a hold created two seconds earlier:

{
  "environment": "sandbox",
  "success": true,
  "requestId": "11487aa1",
  "orderId": "eJzTd9ePNA90dHUGAAsuAlA",
  "processingTime": 2.147,
  "booking": {
    "reference": "Y7QAEC",
    "status": "cancelled",
    "pnr": "Y7QAEC",
    "type": "hold",
    "createdAt": "2026-11-01T15:26:27.977426+00:00",
    "cancelledAt": "2026-11-01T15:26:30.748257",
    "content": "managed",
    "syncedAt": "2026-11-01T15:26:30.748257",
    "availableActions": [],
    "voidableUntil": null,
    "cancellation": { "type": "void", "deleted": true, "deletedAt": "2026-11-01T15:26:30.748257" }
  },
  "supplier": { "id": "amadeus_aqc_dz_1", "technology": "amadeus_aqc", "name": "Amadeus Algeria", "offerId": null },
  "agency": { "currency": "DZD" },
  "cancellation": {
    "status": "deleted",
    "deleted": true,
    "deletedAt": "2026-11-01T15:26:30.748257",
    "refundAmount": 0,
    "refundCurrency": "DZD",
    "refundTo": null,
    "message": "Reservation deleted successfully."
  },
  "meta": {
    "supportHold": true,
    "supportVoid": true,
    "voidDeadline": "2026-11-01T23:00:00Z",
    "voidWindowEndsAt": null,
    "airlineInitiatedChanges": [],
    "changes": [],
    "users": [],
    "orderMetadata": { "supplierStatusCode": 204, "supplierDeleteErrorIgnored": false, "supplierDeleteErrorCode": 204, "supplierDeleteErrorMessage": null }
  },
  "postProcessing": { "bookingStatusUpdated": true }
}

Field meanings

Cancelling a hold does not touch your balance: nothing was ever debited. The booking stays readable with get_booking (status cancelled).

Errors

A supplier failure while deleting is answered with the supplier's status and message.

Related

• Book a flight (hold), Pay a held booking and Booking flows.