---
title: "Check the status of an exchange"
method: POST
path: "/v1/exchange_status"
tags: ["Post-booking"]
---

# Check the status of an exchange

`POST /v1/exchange_status`

## Request

- Base URL: `https://api.gojinko.com`
- URL: `https://api.gojinko.com/v1/exchange_status`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Call get_booking first. Use booking_ref and the selected booked_item_id for every servicing action. last_name is required for guest lookup; an owning credential may omit it. The deprecated `provider`, `order_id`, `provider_reference` and `provider_booking_id` are accepted until 2027-04-30 where the request declares them; a request that sends one is answered with `Deprecation` and `Sunset` headers. A 409 item_selection_required returns safe items to choose from.

## Request body

- ExchangeStatusRequest
  - `booking_ref` string: Jinko booking reference. Call get_booking first, then select its booked_item_id for servicing.
  - `booked_item_id` string: The booked item, from get_booking items[].booked_item_id. Preserved across exchanges. Omit only when the booking has exactly one item of the requested domain; otherwise a 409 returns items to choose from.
  - `last_name` string: Required for guest lookup. A credential that owns the booking may omit it; ownership is checked by the platform.
  - `order_id` string: Deprecated: name the booking with booking_ref and booked_item_id from get_booking. Names the booking instead of booking_ref, never beside it, and needs a credential that owns the booking. Accepted until 2027-04-30; a request that sends it is answered with `Deprecation` and `Sunset` headers.
  - `provider` string: Deprecated: omit it. The platform uses the supplier recorded with the booking. Accepted until 2027-04-30; a request that sends it is answered with `Deprecation` and `Sunset` headers.
  - `intent` IntentInput
    - `user_intent` string, nullable: The user's natural-language intent: the Alpic PII-stripped paraphrase when available, else a best-effort fallback to the client-provided NL query.

## Response `200`

Check the status of an exchange

- ExchangeStatusResponse
  - `airline_locator` string: Deprecated: read the item’s `supplier_references` on POST /v1/get_booking, which carries each airline’s record locator with the airline that issued it. Airline record locator for the current itinerary.
  - `booking_ref` string
  - `booking_reference` string: Deprecated: use `booking_ref` instead. Same value.
  - `status` 'confirmed' | 'pending' | 'partial_failure' | 'failed': `pending` until the exchange is carried out — including while it waits for the customer’s payment, and while a Jinko agent has it (`manual_handling`).
  - `new_ticket_numbers` string[]
  - `confirmed_payment_outcome` string
  - `checkout_url` string: Present while the exchange waits for the customer to pay the difference: the same page exchange_commit returned. The exchange runs once that payment authorizes.
  - `manual_handling` object: Present while the exchange is with a Jinko agent: it could not be completed automatically. `status` stays `PENDING` and polling does not move it; the agent does. Absent once the exchange is carried out or failed.
    - `status` 'pending', required: `pending` — a Jinko agent has the exchange and will complete or fail it.
  - `warnings` string[]: Notes about the booking and its documents, each said once, in words the customer can be shown. A note the supplier sends as free text without a code is left out.

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `402`: Payment required — organization balance exhausted
- `404`: Resource not found
- `409`: Choose booked_item_id when several booked items match; other conflicts report the current resource state.
- `410`: The resource this request names no longer exists
- `422`: Validation error
- `429`: Rate limit or quota exceeded
- `502`: The travel provider rejected the request, or an upstream call failed
- `503`: No travel provider can serve the request right now
- `504`: The travel provider did not answer in time

---

[API](https://skmtc.dev/gojinko/apis/jinko-public-api.md) - [All operations](https://skmtc.dev/gojinko/apis/jinko-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gojinko/apis/jinko-public-api/revisions/ac5046767e4c?raw)