POST/v1/flights/order/pending/cancel/:gdsprovider/:orderId

Create pending flight cancellation

Starts a pending cancellation flow so the integration can review refund data, penalties or provider confirmation before final cancellation.

Endpoint

Method	Path	Auth
`POST`	`/v1/flights/order/pending/cancel/:gdsprovider/:orderId`	Required API key

Required headers:

Header	Description
`Authorization`	`Bearer <secret_key>`. The secret is shown only once when the credential is created.
`X-Travelandz-Id`	`<public_key>:<profile_code>`. The `profile_code` is the `dp_`-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential.
`Content-Type`	Use `application/json` for requests with a body.

Property	Type	Details	Required	Notes
`gdsprovider`	`number`		Yes	Only gdsprovider "0" supports this flow
`orderId`	`string`		Yes	-

Returns the pending cancellation id and provider state.

Property	Type	Details	Required	Notes
`data`	`object`		Yes	-
`refund_to`	`string`		Yes	-
`refund_currency`	`string`		Yes	-
`refund_amount`	`string`		Yes	-
`order_id`	`string`		Yes	-
`live_mode`	`boolean`		Yes	-
`id`	`string`		Yes	-
`expires_at`	`string`	`Format: ISO 8601`	Yes	-
`created_at`	`string`	`Format: ISO 8601`	Yes	-
`confirmed_at`	`string`	`Format: ISO 8601`	Yes	-
`airline_credits`	`array`		Yes	-
`passenger_id`	`string`		Yes	-
`issued_on`	`string`	`Format: ISO 8601`	Yes	-
`id`	`string`		Yes	-
`credit_name`	`string`		Yes	-
`credit_currency`	`string`		Yes	-
`credit_code`	`string`		Yes	-
`credit_amount`	`string`		Yes	-

Only gdsprovider "0" supports this flow. Store the returned cancellation id and confirm details before finalizing.