Reference · step 9 of 9
POST/flights/booking/release
{{base_url}}/flights/booking/release
Give up a held booking: the PNR is released at the airline and the order becomes PNR_RELEASED. A ticketed booking cannot be released.
Headers
| Content-Type | application/json |
| Authorization | Bearer {{token}} |
Reply (1 notes)
- success is false when every provider release failed; status then stays as it was.
Keys and what they mean
Request
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| booking_id | string | required | must read | A booking on hold. A booking that is not on hold answers an error. |
| Total: 1 keys | ||||
Reply
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| status | string | always | must read | PNR_RELEASED when the airline freed the seats. A release the airline refuses answers 409 (code 3105): the PNR is still held, try again later. |
| pnr | string | always | useful | The record locator that was released. |
| booking_id | string | always | informational | The booking released. |
| Total: 3 keys | ||||
Errors this call answers with (5)
| HTTP | code | message | detail | when |
|---|---|---|---|---|
| 401 | 9001 | Authentication required | Invalid token | |
| 403 | 9002 | You do not have permission for this action | Role without bookings.cancel. | |
| 400 | 3000 | Invalid request | Booking_id is required | |
| 404 | 9005 | Not found | Booking not found | |
| 409 | 3102 | Booking is not pending | Ticketed or already released. |
Questions developers ask (1)
- Release answered 409 3105. Is the booking released?
- No. The airline did not give the PNR back; it stays held until pay_till. Try again later.
Real captures of this call
- Domestic, one way, 1 adult · HTTP 409 · reply in the viewer
- Domestic, one way, 1 adult, 1 child, 1 infant · HTTP 409 · reply in the viewer
- Domestic, return, 1 adult · HTTP 200 · reply in the viewer
- Domestic, return, 1 adult, 1 child, 1 infant · HTTP 409 · reply in the viewer
- Hold, then release the hold · HTTP 200 · reply in the viewer