Cancel Conditions

Returns the preview of what cancelling the order right now would refund, per ticket — before any cancellation is performed. Use it to show the penalty/refund before a cancellation is confirmed. After the order is actually cancelled, query Refund for the amounts realised.

This is a safe, idempotent read.

Endpoint

Method: GET

URL: /v1/order/{order_id}/cancel-conditions

Request Headers

Parameter	Type	Required	Description
Authorization	String	Yes	Bearer <token> from Login

Path Parameters

Parameter	Type	Required	Description
order_id	String	Yes	Provider order id (Order.id returned by Create Order)

Query Parameters

Parameter	Type	Required	Description
locale	String	No	Localises the human-readable refund notes, refer to Locale List

Response Parameters

Parameter	Type	Required	Description
└ conditions	Object	Yes	Per-order refund summary
└ can_be_canceled	Boolean	No	Whether the order may still be cancelled
└ return_available_till	String	No	Deadline for a return (ISO-8601 with offset)
└ currency	String	No	Order-level currency (a ticket may override it)
└ tickets	[RefundTicket]	Yes	Per-ticket refund lines
└ ticket_code	String	Yes	Provider booking/system code (matches OrderTicket.code)
└ currency	String	No	Currency
└ refund_amount	Number	No	Amount refunded to the customer
└ refund_fee_amount	Number	No	Penalty/fee withheld from the refund
└ refund_tax_amount	Number	No	Tax component withheld
└ full_refund	Boolean	No	Whole ticket price refunded (ignores per-ticket amounts)
└ route_changed	Boolean	No	Refund is due to a provider route change
└ additional_info	String	No	Free-text note shown to the operator

Response Example

{
  "conditions": {
    "can_be_canceled": true,
    "return_available_till": "2026-06-30T23:59:00+03:00",
    "currency": "UAH",
    "tickets": [
      {
        "ticket_code": "BK-9931",
        "currency": "UAH",
        "refund_amount": 585.0,
        "refund_fee_amount": 65.0,
        "refund_tax_amount": 0.0,
        "full_refund": false,
        "route_changed": false,
        "additional_info": "10% cancellation fee applies"
      }
    ]
  }
}

Error Code List

code	message	Description
UNAUTHORIZED	Invalid token	The bearer token is missing, invalid, or expired (401).
NOT_FOUND	Order not found	No order exists for the supplied order_id.
NOT_CANCELABLE	Order cannot be cancelled	The order is already canceled or expired.