@gojinko/api-client 2.24.0 → 2.26.0

package/public-api.yaml

@@ -1,10 +1,10 @@
-# synced from jinko-api@cbb5c94917a182f5d2e50a6148e881ed1f0ccef8 (main, #97 squash-merged)
+# synced from jinko-api@558277d11f0dc4707c3e6bf121a97ddf60b12a77 (558277d1)
 # Vendored copy of the canonical public contract. Do not hand-edit: change it in
-# jinko-api, regenerate there, copy the file here, then `pnpm generate:api-types`.
+# jinko-api, then `pnpm sync:api-spec <ref>` here, which also runs `pnpm generate:api-types`.
 openapi: 3.0.0
 info:
   title: Jinko Public API
-  version: 0.8.0
+  version: 0.11.0
   description: >-
     Curated public REST surface for Jinko. Authenticated with jnk_ API keys. See
     https://docs.gojinko.com for guides.
@@ -207,6 +207,16 @@ components:
             on a value-shaped object, fall back to the ISO digits for the
             currency."
           example: 2
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: USD 412.50
       required:
         - value
         - currency
@@ -313,6 +323,7 @@ components:
                 - FORBIDDEN
                 - NOT_FOUND
                 - CONFLICT
+                - GONE
                 - QUOTE_EXPIRED
                 - TRIP_EXPIRED
                 - TRIP_STATE_CONFLICT
@@ -447,6 +458,26 @@ components:
         direct_only:
           type: boolean
           example: false
+        include_carriers:
+          type: array
+          items:
+            type: string
+            pattern: ^[A-Za-z0-9]{2,3}$
+          description: Keep only itineraries whose VALIDATING (ticketing) carrier is in
+            this list — the only carrier field the flight cache carries, unlike
+            the marketing-carrier match on flight_search. 2-3 character
+            IATA/ICAO codes. Must not overlap `exclude_carriers`.
+          example: &a8
+            - UA
+        exclude_carriers:
+          type: array
+          items:
+            type: string
+            pattern: ^[A-Za-z0-9]{2,3}$
+          description: Drop itineraries whose VALIDATING (ticketing) carrier is in this
+            list. Same semantics as `include_carriers`; must not overlap it.
+          example: &a9
+            - NK
         adults:
           type: integer
           minimum: 0
@@ -497,7 +528,7 @@ components:
           default: 0
         sort_by:
           type: string
-          enum: &a8
+          enum: &a10
             - lowest
             - recommendation
           default: lowest
@@ -534,6 +565,19 @@ components:
         next_page_token:
           type: string
           example: eyJvZmZzZXQiOjIwfQ==
+        available_airlines:
+          type: array
+          items:
+            type: string
+          description: VALIDATING (ticketing) carrier codes present across the WHOLE
+            cached match set — not just this page — ordered by itinerary count
+            descending. Lets a caller discover which airlines are available
+            (e.g. to retry with `include_carriers`) without paging through every
+            result. Absent when the platform reports no facet data.
+          example:
+            - UA
+            - DL
+            - AA
       required:
         - itineraries
     FlightDiscoveryRequest:
@@ -604,6 +648,24 @@ components:
         direct_only:
           type: boolean
           example: false
+        include_carriers:
+          type: array
+          items:
+            type: string
+            pattern: ^[A-Za-z0-9]{2,3}$
+          description: Keep only itineraries whose VALIDATING (ticketing) carrier is in
+            this list — the only carrier field the flight cache carries, unlike
+            the marketing-carrier match on flight_search. 2-3 character
+            IATA/ICAO codes. Must not overlap `exclude_carriers`.
+          example: *a8
+        exclude_carriers:
+          type: array
+          items:
+            type: string
+            pattern: ^[A-Za-z0-9]{2,3}$
+          description: Drop itineraries whose VALIDATING (ticketing) carrier is in this
+            list. Same semantics as `include_carriers`; must not overlap it.
+          example: *a9
         adults:
           type: integer
           minimum: 0
@@ -654,7 +716,7 @@ components:
           default: 0
         sort_by:
           type: string
-          enum: *a8
+          enum: *a10
           default: lowest
         intent:
           $ref: "#/components/schemas/IntentInput"
@@ -854,6 +916,22 @@ components:
             on a value-shaped object, fall back to the ISO digits for the
             currency."
           example: 2
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: USD 412.50
+      description: "A money figure in one of two scales, told apart by one rule. When
+        `decimal_places` is present, `value` (or `amount`) is an INTEGER in
+        minor units: divide by 10 ** decimal_places. When it is absent, `amount`
+        is already in MAJOR units. Branch on whether decimal_places is present
+        in the response you received, never on the currency code or the field
+        name. `display` is the same figure as a string to show."
     CheckedBaggage:
       type: object
       properties:
@@ -1364,6 +1442,16 @@ components:
             on a value-shaped object, fall back to the ISO digits for the
             currency."
           example: 2
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: USD 412.50
     MonitoredCarrier:
       type: object
       properties:
@@ -1470,12 +1558,12 @@ components:
           pattern: ^\d{4}-\d{2}-\d{2}$
         origin_type:
           type: string
-          enum: &a9
+          enum: &a11
             - city
             - airport
         destination_type:
           type: string
-          enum: *a9
+          enum: *a11
         cabin_class:
           type: string
           enum: *a7
@@ -1542,39 +1630,7 @@ components:
         description:
           type: string
         price_per_unit:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         per_pax:
           type: boolean
           description: True when the price is charged per passenger rather than once per
@@ -1616,111 +1672,19 @@ components:
       type: object
       properties:
         original:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: The selling price shown at search time, before the quote.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: The selling price shown at search time, before the quote.
         current:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: The selling price the trip is quoted at — the same figure as `price`.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: The selling price the trip is quoted at — the same figure as
+                `price`.
         delta:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "`current` minus `original`, SIGNED: positive when the price rose,
-            negative when it fell."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "`current` minus `original`, SIGNED: positive when the price rose,
+                negative when it fell."
       required:
         - original
         - current
@@ -1751,6 +1715,16 @@ components:
             the guest pays it at the property on top. Getting this backwards
             misquotes the trip.
           example: true
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: EUR 164.49
     CancellationStep:
       type: object
       properties:
@@ -1774,6 +1748,16 @@ components:
           type: string
           description: How the charge is expressed — "amount", "percent" or "nights".
           example: amount
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: EUR 606.13
     HotelTerms:
       type: object
       properties:
@@ -1873,42 +1857,18 @@ components:
             came from. Hotel items only.
           example: lp1f2c3
         price:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: Item total in major currency units. Absent until the trip has been
-            quoted — an unpriced item carries no `price` key at all, so absence
-            means "not priced yet", not "free".
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: Item total in major currency units. Absent until the trip has been
+                quoted — an unpriced item carries no `price` key at all, so
+                absence means "not priced yet", not "free".
+        price_display:
+          type: string
+          description: The item price as a string ready to show, e.g. "EUR 545.55". Sent
+            beside a `price` that arrives as a bare major-units number with
+            `currency` (the trip create response); a `price` object carries its
+            own `display` instead.
+          example: EUR 545.55
         pax_count:
           type: number
           example: 1
@@ -1931,42 +1891,11 @@ components:
             two figures and the signed difference. Absent when the price held.
           example: true
         original_price:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: The snapshot price recorded at search time. Present only when
-            `price_changed` is true; compare it against `price` to show the
-            caller what moved.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: The snapshot price recorded at search time. Present only when
+                `price_changed` is true; compare it against `price` to show the
+                caller what moved.
         price_change:
           $ref: "#/components/schemas/PriceChange"
         required_attributes:
@@ -2051,7 +1980,7 @@ components:
           example: trip_1048576
         status:
           type: string
-          enum: &a10
+          enum: &a12
             - draft
             - quoting
             - quoted
@@ -2101,6 +2030,11 @@ components:
               type: string
             total:
               type: number
+            total_display:
+              type: string
+              description: The trip total as a string ready to show, e.g. "USD 318.40". Absent
+                with `total`.
+              example: USD 318.40
           example:
             currency: USD
             total: 318.4
@@ -2126,7 +2060,7 @@ components:
             - message
         status:
           type: string
-          enum: *a10
+          enum: *a12
           description: The trip state that refused the write. `expired` on TRIP_EXPIRED;
             on TRIP_STATE_CONFLICT it is whichever state the trip is actually
             in. Nothing was changed, so re-reading the trip returns this same
@@ -2331,7 +2265,7 @@ components:
           example: trip_1048576
         status:
           type: string
-          enum: *a10
+          enum: *a12
           description: "Where the trip is in its lifecycle. `expired` is the 24-hour
             lapse: it is evaluated LAZILY, on the read that first observes it,
             so this call is where a dead trip becomes visible. Once a trip is
@@ -2358,39 +2292,7 @@ components:
           items:
             $ref: "#/components/schemas/TripItem"
         total_amount:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         quote:
           type: object
           properties:
@@ -2475,39 +2377,7 @@ components:
           items:
             $ref: "#/components/schemas/SelectedAncillary"
         total_with_ancillaries:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
     AncillaryRequest:
       type: object
       properties:
@@ -2606,15 +2476,19 @@ components:
           example: ready
         expires_at:
           type: string
-          description: "When the locked quote behind this checkout expires (RFC 3339).
-            Roughly five minutes from the call — pay before it passes. This is
-            NOT the lifetime of `checkout_url`, which the platform keeps
-            openable for longer. After this instant the platform REFUSES to take
-            payment rather than charging a stale price: `POST
-            /v1/agent_payment/submit` answers **410 `QUOTE_EXPIRED`** and no
-            payment object is created. To recover, call `POST /v1/checkout`
-            again on the same trip — it re-quotes — and pay against the new
-            `expires_at`. The hosted page offers the same refresh in one click."
+          description: "When the quote behind this checkout stops being payable (RFC
+            3339). Roughly fifteen minutes from the call — pay before it passes.
+            It is NOT a price hold: the supplier guarantees neither the price
+            nor availability for the window, so an offer can lapse inside it.
+            Nor is it the lifetime of `checkout_url`, which stays openable
+            longer. After this instant the platform REFUSES to take payment
+            rather than charging a stale price: `POST /v1/agent_payment/submit`
+            answers **410 `QUOTE_EXPIRED`** and no payment object is created. To
+            recover, call `POST /v1/checkout` again on the same trip — it
+            re-quotes at the current price — and pay against the new
+            `expires_at`. The hosted page cannot recover on its own: past this
+            instant it shows the price as expired and the customer has to be
+            sent a fresh checkout."
           example: "2026-06-01T12:39:56Z"
         payment_type:
           type: string
@@ -2630,39 +2504,7 @@ components:
             you."
           example: checkout
         total_amount:
-          type: object
-          properties:
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         items:
           type: array
           items:
@@ -2725,6 +2567,12 @@ components:
           type: string
           description: The instant the refused quote expired (RFC 3339).
           example: "2026-09-04T12:39:56Z"
+        quoted_cart_id:
+          type: number
+          description: The quote that lapsed — the same `quoted_cart_id` the trip and
+            checkout responses carry, so a caller holding several can tell which
+            one this refusal is about.
+          example: 2097152
       required:
         - error
     AgentPaymentSubmitRequest:
@@ -2759,6 +2607,12 @@ components:
           description: Price for the whole stay in `currency`, at the currency’s own
             precision.
           example: 1818.4
+        total_amount_display:
+          type: string
+          description: 'The rate total as a string ready to show: the ISO 4217 code, a
+            space, then `total_amount` at the currency’s ISO digits, e.g. "EUR
+            606.13". Show this; compute with `total_amount`.'
+          example: EUR 606.13
         currency:
           type: string
           example: EUR
@@ -3207,6 +3061,15 @@ components:
           type: string
         decimal_places:
           type: integer
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
       required:
         - value
         - currency
@@ -3528,6 +3391,16 @@ components:
             on a value-shaped object, fall back to the ISO digits for the
             currency."
           example: 2
+        display:
+          type: string
+          description: 'The same figure as a string ready to show: the ISO 4217 code, a
+            space, then the amount, e.g. "USD 159.77". With decimal_places it is
+            written at exactly that scale (value 1561500, JPY, decimal_places 2
+            is "JPY 15615.00"); without, at the ISO digits of the currency. Show
+            this; compute with the number. Absent when the figure is not money
+            (a cancellation step expressed as a percent or a number of nights)
+            or could not be read unambiguously.'
+          example: EUR 412.50
       description: The only amount Jinko charges at checkout.
     CarOfferPrice:
       type: object
@@ -3841,7 +3714,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: &a11
+      example: &a13
         booking_ref: JNK-8PT9VS
         last_name: Carrard
     CarCancelCommitResponse:
@@ -3946,7 +3819,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a11
+      example: *a13
     CarExchangeVehicle:
       type: object
       properties:
@@ -4300,7 +4173,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a11
+      example: *a13
     DestinationSnapshotRow:
       type: object
       properties:
@@ -4446,6 +4319,50 @@ components:
         `UNSUPPORTED` — the provider or fare does not allow it at all; nothing
         you send will change that. Do not treat MANUAL_REQUIRED as a failure,
         and do not retry UNSUPPORTED.
+    BookingCalendarFile:
+      type: object
+      properties:
+        method:
+          type: string
+          description: "The iTIP method (RFC 5546) this file carries: `REQUEST` for the
+            events the booking still holds, `CANCEL` for the ones it no longer
+            does. One file carries exactly one method — a booking that both
+            retires and confirms flights, which is what an exchange does, comes
+            back as two files rather than one mixed one."
+          example: REQUEST
+        filename:
+          type: string
+          description: The name the confirmation or cancellation email attached this same
+            file under.
+          example: jinko-JNK-A0AUR2.ics
+        content_type:
+          type: string
+          description: "The media type, including the `method` parameter. Attach or serve
+            the file under this exact value: the method parameter is what makes
+            a mail client act on the file instead of storing it as a plain
+            attachment."
+          example: text/calendar; charset=utf-8; method=REQUEST
+        content:
+          type: string
+          description: The iCalendar file itself. Real CRLF line endings, as iCalendar
+            requires — the example escapes them only so it can be read here.
+            Byte-identical to what the email carried for the current state of
+            this booking.
+          example: BEGIN:VCALENDAR\r\nVERSION:2.0\r\n…\r\nEND:VCALENDAR\r\n
+    BookingCalendar:
+      type: object
+      properties:
+        files:
+          type: array
+          items:
+            $ref: "#/components/schemas/BookingCalendarFile"
+          description: "The iCalendar files this booking is carried in, cancellation first
+            and then invitation — the order the emails attach them in. Never
+            empty: a booking with nothing to put in a calendar omits `calendar`
+            altogether."
+      description: The calendar entries for this booking, as iCalendar files. Absent —
+        not null, and never an empty list — when the booking holds no flight and
+        no hotel, and whenever the files could not be built.
     Booking:
       type: object
       properties:
@@ -4466,39 +4383,7 @@ components:
           type: string
           example: Carrard
         total_paid:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         refund_support_level:
           $ref: "#/components/schemas/SupportLevel"
         exchange_support_level:
@@ -4506,6 +4391,8 @@ components:
         created_at:
           type: string
           example: "2026-05-20T09:14:00Z"
+        calendar:
+          $ref: "#/components/schemas/BookingCalendar"
       description: "The booked trip. Minimally described — the platform sends more
         (items, per-item confirmations, provider state) and all of it reaches
         you. The two `*_support_level` fields are a SNAPSHOT: a fare’s void
@@ -4528,6 +4415,12 @@ components:
             currency: USD
             decimal_places: 2
           created_at: "2026-05-20T09:14:00Z"
+          calendar:
+            files:
+              - method: REQUEST
+                filename: jinko-JNK-A0AUR2.ics
+                content_type: text/calendar; charset=utf-8; method=REQUEST
+                content: BEGIN:VCALENDAR\r\nVERSION:2.0\r\n…\r\nEND:VCALENDAR\r\n
     GetBookingRequest:
       type: object
       properties:
@@ -4568,112 +4461,17 @@ components:
             MANUAL_REQUIRED`."
           example: fare rules require agent review
         refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "What would be refunded. **Absent is not zero** — on a voidable
-            ticket (`is_voidable: true`) the whole charge is reversed and no
-            amount is quoted, and on an unsupported refund nothing is computed
-            at all. Read `is_refundable` and `is_voidable` before showing a
-            figure."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "What would be refunded. **Absent is not zero** — on a voidable
+                ticket (`is_voidable: true`) the whole charge is reversed and no
+                amount is quoted, and on an unsupported refund nothing is
+                computed at all. Read `is_refundable` and `is_voidable` before
+                showing a figure."
         penalty_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         total_paid:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         expires_at:
           type: string
           example: "2026-06-02T00:00:00Z"
@@ -4701,7 +4499,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: &a12
+      example: &a14
         booking_ref: JNK-A0AUR2
         last_name: Carrard
     ServicingState:
@@ -4732,113 +4530,18 @@ components:
       type: object
       properties:
         refund_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         penalty_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         currency:
           type: string
           example: USD
         total_paid_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: What the airline recorded as paid to it for this item, net of
-            Jinko’s margin. The base `refund_net` is measured against, and not
-            what the customer paid.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: What the airline recorded as paid to it for this item, net of
+                Jinko’s margin. The base `refund_net` is measured against, and
+                not what the customer paid.
       description: "The airline's own net figures, for reconciliation — never what the
         customer receives. `refund_net` is what the airline returns to Jinko,
         `penalty_net` what it withheld from Jinko and `total_paid_net` what it
@@ -4882,86 +4585,24 @@ components:
         operation_kind:
           $ref: "#/components/schemas/FlightOperationKind"
         refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "THE CUSTOMER FIGURE: what goes back to the payment method that
-            paid for this ticket — what they paid, less the penalty, or the
-            whole charge when the ticket was voided (`operation_kind: void`).
-            Show this one. `confirmed_refund_amount` beside it is the airline's
-            net figure and is smaller on any ticket sold at a margin. Absent is
-            not zero."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "THE CUSTOMER FIGURE: what goes back to the payment method that
+                paid for this ticket — what they paid, less the penalty, or the
+                whole charge when the ticket was voided (`operation_kind:
+                void`). Show this one. `confirmed_refund_amount` beside it is
+                the airline's net figure and is smaller on any ticket sold at a
+                margin. Absent is not zero."
         confirmed_refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: The AIRLINE's net refund — what the supplier returns to Jinko, not
-            what the customer receives — kept unchanged for one contract version
-            under the name it has always had. Read `refund_amount` for the
-            customer and `provider_figures.refund_net` for reconciliation; this
-            field is removed in the next version. Omitted on a void, where no
-            supplier figure is read at all.
-          deprecated: true
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: The AIRLINE's net refund — what the supplier returns to Jinko, not
+                what the customer receives — kept unchanged for one contract
+                version under the name it has always had. Read `refund_amount`
+                for the customer and `provider_figures.refund_net` for
+                reconciliation; this field is removed in the next version.
+                Omitted on a void, where no supplier figure is read at all.
+              deprecated: true
         provider_figures:
           $ref: "#/components/schemas/FlightProviderFigures"
         refund_reference:
@@ -4991,7 +4632,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a12
+      example: *a14
     RefundStatusResponse:
       type: object
       properties:
@@ -5018,42 +4659,11 @@ components:
         state:
           $ref: "#/components/schemas/ServicingState"
         refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "THE CUSTOMER FIGURE: what goes back to the payment method — the
-            settled figure once the refund has settled, the quoted one before.
-            Absent is not zero."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "THE CUSTOMER FIGURE: what goes back to the payment method — the
+                settled figure once the refund has settled, the quoted one
+                before. Absent is not zero."
         refund_reference:
           type: string
           example: rfnd_3c91f0a2
@@ -5083,7 +4693,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a12
+      example: *a14
     ExchangeOffer:
       type: object
       properties:
@@ -5101,39 +4711,7 @@ components:
             /v1/exchange_price is the binding figure.
           example: additional_payment_due
         estimated_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         validating_carrier:
           type: string
           example: AA
@@ -5176,7 +4754,7 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a12
+      example: *a14
     ExchangePriceResponse:
       type: object
       properties:
@@ -5184,141 +4762,13 @@ components:
           type: string
           example: additional_payment_due
         fare_difference:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         penalty_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         total_due:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         total_refund:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         session_reference:
           type: string
           example: exch_7a1c93f0
@@ -5451,78 +4901,14 @@ components:
       required:
         - booking_ref
         - last_name
-      example: *a12
-    ProviderFigures:
-      type: object
-      properties:
-        refund_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+      example: *a14
+    ProviderFigures:
+      type: object
+      properties:
+        refund_net:
+          $ref: "#/components/schemas/Money"
         penalty_net:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
+          $ref: "#/components/schemas/Money"
         currency:
           type: string
           example: USD
@@ -5555,124 +4941,31 @@ components:
         state:
           $ref: "#/components/schemas/ServicingState"
         refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "THE CUSTOMER FIGURE: what goes back to the payment method that
-            paid for this booking — what the customer paid for it, less
-            `penalty_amount`. Up to contract version 0.3.0 this field carried
-            the SUPPLIER's net refund instead, which on a booking sold at a
-            margin is a smaller number; the supplier's figure now lives in
-            `provider_figures.refund_net`. Absent when no refund was scheduled —
-            absent is not zero."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "THE CUSTOMER FIGURE: what goes back to the payment method that
+                paid for this booking — what the customer paid for it, less
+                `penalty_amount`. Up to contract version 0.3.0 this field
+                carried the SUPPLIER's net refund instead, which on a booking
+                sold at a margin is a smaller number; the supplier's figure now
+                lives in `provider_figures.refund_net`. Absent when no refund
+                was scheduled — absent is not zero."
         customer_refund_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: Deprecated alias of `refund_amount`, carrying the same value. It
-            existed because `refund_amount` used to be the supplier figure; now
-            that `refund_amount` IS the customer figure the alias is redundant.
-            Read `refund_amount` — this field is removed in the next contract
-            version.
-          deprecated: true
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: Deprecated alias of `refund_amount`, carrying the same value. It
+                existed because `refund_amount` used to be the supplier figure;
+                now that `refund_amount` IS the customer figure the alias is
+                redundant. Read `refund_amount` — this field is removed in the
+                next contract version.
+              deprecated: true
         penalty_amount:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: "The cancellation penalty withheld from the customer, on the same
-            basis as `refund_amount`: what they paid, less this, is what they
-            get back. The penalty the SUPPLIER withheld from Jinko is
-            `provider_figures.penalty_net`."
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: "The cancellation penalty withheld from the customer, on the same
+                basis as `refund_amount`: what they paid, less this, is what
+                they get back. The penalty the SUPPLIER withheld from Jinko is
+                `provider_figures.penalty_net`."
         provider_figures:
           $ref: "#/components/schemas/ProviderFigures"
         connector_reference:
@@ -5765,89 +5058,32 @@ components:
             holding several items is quoted and cancelled one item at a time.
           example: itm_7f2c9a4e8b1d
         refund:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            basis:
-              type: string
-              description: How the figure was computed. `sell_minus_penalty` — what the
-                customer paid for this item, less the penalty. `original_charge`
-                — the entire charge is reversed, penalty-free (a void). The
-                platform chooses; the caller cannot ask for one.
-              example: sell_minus_penalty
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                basis:
+                  type: string
+                  description: How the figure was computed. `sell_minus_penalty` — what the
+                    customer paid for this item, less the penalty.
+                    `original_charge` — the entire charge is reversed,
+                    penalty-free (a void). The platform chooses; the caller
+                    cannot ask for one.
+                  example: sell_minus_penalty
           description: "THE CUSTOMER FIGURE: what would go back to the payment method, on
             the basis named in `basis`. Show this one. Absent is not zero."
         penalty:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            fee_known:
-              type: boolean
-              description: false means the penalty could not be established — UNKNOWN, not
-                zero. Render it as "we will confirm the fee", never as free
-                cancellation, and expect the final figure on the operation
-                status.
-              example: true
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                fee_known:
+                  type: boolean
+                  description: false means the penalty could not be established — UNKNOWN, not
+                    zero. Render it as "we will confirm the fee", never as free
+                    cancellation, and expect the final figure on the operation
+                    status.
+                  example: true
           description: What the customer would forfeit — read `fee_known` before showing it.
         policy:
           type: object
@@ -5872,43 +5108,7 @@ components:
                     description: When this step starts applying.
                     example: "2026-09-01T00:00:00Z"
                   amount:
-                    type: object
-                    properties:
-                      value:
-                        type: integer
-                        description: "Integer amount in MINOR units, always paired with decimal_places —
-                          divide by 10 ** decimal_places to display. Example:
-                          value 15977 with decimal_places 2 is 159.77 USD.
-                          Rendering this field directly shows prices 100x too
-                          high for 2-decimal currencies."
-                        example: 41250
-                      amount:
-                        type: number
-                        description: Alternative to `value` on some endpoints (the two never appear
-                          together); its scale depends on decimal_places. When
-                          this object carries decimal_places, amount is an
-                          INTEGER in minor units — divide by 10 **
-                          decimal_places (e.g. select_ancillaries
-                          total_with_ancillaries). When there is no
-                          decimal_places field, amount is a decimal in MAJOR
-                          units, safe to display as-is (e.g. trip and checkout
-                          totals).
-                      currency:
-                        type: string
-                        description: ISO 4217 currency code.
-                        example: USD
-                      decimal_places:
-                        type: integer
-                        description: "Scale of the integer value/amount: display = integer / 10 **
-                          decimal_places. Always sent alongside minor-unit
-                          amounts. Usually the ISO 4217 digits of the currency
-                          (2 for USD/EUR/GBP, 0 for JPY/KRW, 3 for BHD/JOD/KWD)
-                          but currency-converted prices can carry a different
-                          scale — ALWAYS use the decimal_places sent with the
-                          amount, never a hardcoded 2. Only if the field is
-                          genuinely absent on a value-shaped object, fall back
-                          to the ISO digits for the currency."
-                        example: 2
+                    $ref: "#/components/schemas/Money"
                   fraction:
                     type: number
                     description: The share of the paid price withheld from `from` onwards, when the
@@ -6024,41 +5224,7 @@ components:
           type: object
           properties:
             refund:
-              type: object
-              properties:
-                value:
-                  type: integer
-                  description: "Integer amount in MINOR units, always paired with decimal_places —
-                    divide by 10 ** decimal_places to display. Example: value
-                    15977 with decimal_places 2 is 159.77 USD. Rendering this
-                    field directly shows prices 100x too high for 2-decimal
-                    currencies."
-                  example: 41250
-                amount:
-                  type: number
-                  description: Alternative to `value` on some endpoints (the two never appear
-                    together); its scale depends on decimal_places. When this
-                    object carries decimal_places, amount is an INTEGER in minor
-                    units — divide by 10 ** decimal_places (e.g.
-                    select_ancillaries total_with_ancillaries). When there is no
-                    decimal_places field, amount is a decimal in MAJOR units,
-                    safe to display as-is (e.g. trip and checkout totals).
-                currency:
-                  type: string
-                  description: ISO 4217 currency code.
-                  example: USD
-                decimal_places:
-                  type: integer
-                  description: "Scale of the integer value/amount: display = integer / 10 **
-                    decimal_places. Always sent alongside minor-unit amounts.
-                    Usually the ISO 4217 digits of the currency (2 for
-                    USD/EUR/GBP, 0 for JPY/KRW, 3 for BHD/JOD/KWD) but
-                    currency-converted prices can carry a different scale —
-                    ALWAYS use the decimal_places sent with the amount, never a
-                    hardcoded 2. Only if the field is genuinely absent on a
-                    value-shaped object, fall back to the ISO digits for the
-                    currency."
-                  example: 2
+              $ref: "#/components/schemas/Money"
           description: The customer refund as it stands now, on `quote_drift`. This is
             what the customer would get if they accepted the new quote.
         active_operation:
@@ -6069,43 +5235,13 @@ components:
             /v1/flight_refund_status.
           example: svc_01J7ZR5Q2KME8V4T
         shortfall:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: How much of the refund could not be reserved, on
-            `funds_unavailable`. The refusal is about money still moving on the
-            original payment, not about this booking, so this is the figure that
-            says how much has to clear before a commit can succeed.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: How much of the refund could not be reserved, on
+                `funds_unavailable`. The refusal is about money still moving on
+                the original payment, not about this booking, so this is the
+                figure that says how much has to clear before a commit can
+                succeed.
         blocking:
           type: array
           items:
@@ -6259,58 +5395,29 @@ components:
             still moving — that is the normal middle of a cancellation, not a
             discrepancy.
         money:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            direction:
-              type: string
-              description: Which way the money moves. `refund` on a cancellation.
-              example: refund
-            vehicle_state:
-              type: string
-              description: "How far the money itself has got, independently of the supplier:
-                `reserved` (earmarked, nothing sent), `refund_pending`
-                (submitted to the payment provider), `payout_initiated` and
-                `payout_settled` (paid out to a third party), `paid` (it has
-                reached the customer), `released` (earmark dropped, nothing
-                owed), `refund_review` (a person at Jinko has to release it).
-                Only `paid` and `payout_settled` mean the customer has the
-                money."
-              example: paid
-            stripe_reference:
-              type: string
-              description: The payment provider's own refund id, once one exists.
-              example: re_3UBIxK2eZvKYlo2C
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                direction:
+                  type: string
+                  description: Which way the money moves. `refund` on a cancellation.
+                  example: refund
+                vehicle_state:
+                  type: string
+                  description: "How far the money itself has got, independently of the supplier:
+                    `reserved` (earmarked, nothing sent), `refund_pending`
+                    (submitted to the payment provider), `payout_initiated` and
+                    `payout_settled` (paid out to a third party), `paid` (it has
+                    reached the customer), `released` (earmark dropped, nothing
+                    owed), `refund_review` (a person at Jinko has to release
+                    it). Only `paid` and `payout_settled` mean the customer has
+                    the money."
+                  example: paid
+                stripe_reference:
+                  type: string
+                  description: The payment provider's own refund id, once one exists.
+                  example: re_3UBIxK2eZvKYlo2C
           description: The refund and where it has got to. Read `vehicle_state` before
             telling a customer they have been refunded.
     HotelCancelStatusRequest:
@@ -6461,100 +5568,43 @@ components:
         item:
           type: string
           description: The booked item this quote covers ("itm_…"). A booking holding
-            several items is quoted and refunded one item at a time; within an
-            item, every ticket issued for it is covered together.
-          example: itm_7f2c9a4e8b1d
-        provider:
-          type: string
-          description: Which supplier the operation would be sent to. Informational.
-          example: sabre-rest
-        refund:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            basis:
-              type: string
-              description: How the figure was computed. `sell_minus_penalty` — what the
-                customer paid for this item, less the penalty. `original_charge`
-                — the entire charge is reversed, penalty-free (a void). The
-                platform chooses; the caller cannot ask for one.
-              example: sell_minus_penalty
+            several items is quoted and refunded one item at a time; within an
+            item, every ticket issued for it is covered together.
+          example: itm_7f2c9a4e8b1d
+        provider:
+          type: string
+          description: Which supplier the operation would be sent to. Informational.
+          example: sabre-rest
+        refund:
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                basis:
+                  type: string
+                  description: How the figure was computed. `sell_minus_penalty` — what the
+                    customer paid for this item, less the penalty.
+                    `original_charge` — the entire charge is reversed,
+                    penalty-free (a void). The platform chooses; the caller
+                    cannot ask for one.
+                  example: sell_minus_penalty
           description: "THE CUSTOMER FIGURE: what would go back to the payment method, on
             the basis named in `basis` — what they paid less the penalty, or the
             entire charge on a void. Show this one, never `provider_figures`.
             Absent is not zero: a quote whose penalty is unknown carries no
             refund figure at all."
         penalty:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            fee_known:
-              type: boolean
-              description: false means the penalty could not be established — UNKNOWN, not
-                zero. Render it as "we will confirm the fee", never as free
-                cancellation, and expect the final figure on the operation
-                status.
-              example: true
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                fee_known:
+                  type: boolean
+                  description: false means the penalty could not be established — UNKNOWN, not
+                    zero. Render it as "we will confirm the fee", never as free
+                    cancellation, and expect the final figure on the operation
+                    status.
+                  example: true
           description: What the customer would forfeit, in the currency they were charged.
             Zero on a void. Read `fee_known` before showing it — false means
             UNKNOWN, not free.
@@ -6620,7 +5670,7 @@ components:
           example: Carrard
         intent:
           $ref: "#/components/schemas/IntentInput"
-      example: *a12
+      example: *a14
     FlightRefundCommitResponse:
       type: object
       properties:
@@ -6699,41 +5749,7 @@ components:
           type: object
           properties:
             refund:
-              type: object
-              properties:
-                value:
-                  type: integer
-                  description: "Integer amount in MINOR units, always paired with decimal_places —
-                    divide by 10 ** decimal_places to display. Example: value
-                    15977 with decimal_places 2 is 159.77 USD. Rendering this
-                    field directly shows prices 100x too high for 2-decimal
-                    currencies."
-                  example: 41250
-                amount:
-                  type: number
-                  description: Alternative to `value` on some endpoints (the two never appear
-                    together); its scale depends on decimal_places. When this
-                    object carries decimal_places, amount is an INTEGER in minor
-                    units — divide by 10 ** decimal_places (e.g.
-                    select_ancillaries total_with_ancillaries). When there is no
-                    decimal_places field, amount is a decimal in MAJOR units,
-                    safe to display as-is (e.g. trip and checkout totals).
-                currency:
-                  type: string
-                  description: ISO 4217 currency code.
-                  example: USD
-                decimal_places:
-                  type: integer
-                  description: "Scale of the integer value/amount: display = integer / 10 **
-                    decimal_places. Always sent alongside minor-unit amounts.
-                    Usually the ISO 4217 digits of the currency (2 for
-                    USD/EUR/GBP, 0 for JPY/KRW, 3 for BHD/JOD/KWD) but
-                    currency-converted prices can carry a different scale —
-                    ALWAYS use the decimal_places sent with the amount, never a
-                    hardcoded 2. Only if the field is genuinely absent on a
-                    value-shaped object, fall back to the ISO digits for the
-                    currency."
-                  example: 2
+              $ref: "#/components/schemas/Money"
           description: The customer refund as it stands now, on `quote_drift`. This is
             what the customer would get if they accepted the new quote.
         active_operation:
@@ -6744,43 +5760,13 @@ components:
             /v1/flight_refund_status.
           example: svc_01J7ZR5Q2KME8V4T
         shortfall:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-          description: How much of the refund could not be reserved, on
-            `funds_unavailable`. The refusal is about money still moving on the
-            original payment, not about this booking, so this is the figure that
-            says how much has to clear before a commit can succeed.
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - description: How much of the refund could not be reserved, on
+                `funds_unavailable`. The refusal is about money still moving on
+                the original payment, not about this booking, so this is the
+                figure that says how much has to clear before a commit can
+                succeed.
         blocking:
           type: array
           items:
@@ -6964,58 +5950,29 @@ components:
             money is still moving — that is the normal middle of a refund, not a
             discrepancy.
         money:
-          type: object
-          properties:
-            value:
-              type: integer
-              description: "Integer amount in MINOR units, always paired with decimal_places —
-                divide by 10 ** decimal_places to display. Example: value 15977
-                with decimal_places 2 is 159.77 USD. Rendering this field
-                directly shows prices 100x too high for 2-decimal currencies."
-              example: 41250
-            amount:
-              type: number
-              description: Alternative to `value` on some endpoints (the two never appear
-                together); its scale depends on decimal_places. When this object
-                carries decimal_places, amount is an INTEGER in minor units —
-                divide by 10 ** decimal_places (e.g. select_ancillaries
-                total_with_ancillaries). When there is no decimal_places field,
-                amount is a decimal in MAJOR units, safe to display as-is (e.g.
-                trip and checkout totals).
-            currency:
-              type: string
-              description: ISO 4217 currency code.
-              example: USD
-            decimal_places:
-              type: integer
-              description: "Scale of the integer value/amount: display = integer / 10 **
-                decimal_places. Always sent alongside minor-unit amounts.
-                Usually the ISO 4217 digits of the currency (2 for USD/EUR/GBP,
-                0 for JPY/KRW, 3 for BHD/JOD/KWD) but currency-converted prices
-                can carry a different scale — ALWAYS use the decimal_places sent
-                with the amount, never a hardcoded 2. Only if the field is
-                genuinely absent on a value-shaped object, fall back to the ISO
-                digits for the currency."
-              example: 2
-            direction:
-              type: string
-              description: Which way the money moves. `refund` on a cancellation.
-              example: refund
-            vehicle_state:
-              type: string
-              description: "How far the money itself has got, independently of the supplier:
-                `reserved` (earmarked, nothing sent), `refund_pending`
-                (submitted to the payment provider), `payout_initiated` and
-                `payout_settled` (paid out to a third party), `paid` (it has
-                reached the customer), `released` (earmark dropped, nothing
-                owed), `refund_review` (a person at Jinko has to release it).
-                Only `paid` and `payout_settled` mean the customer has the
-                money."
-              example: paid
-            stripe_reference:
-              type: string
-              description: The payment provider's own refund id, once one exists.
-              example: re_3UBIxK2eZvKYlo2C
+          allOf:
+            - $ref: "#/components/schemas/Money"
+            - type: object
+              properties:
+                direction:
+                  type: string
+                  description: Which way the money moves. `refund` on a cancellation.
+                  example: refund
+                vehicle_state:
+                  type: string
+                  description: "How far the money itself has got, independently of the supplier:
+                    `reserved` (earmarked, nothing sent), `refund_pending`
+                    (submitted to the payment provider), `payout_initiated` and
+                    `payout_settled` (paid out to a third party), `paid` (it has
+                    reached the customer), `released` (earmark dropped, nothing
+                    owed), `refund_review` (a person at Jinko has to release
+                    it). Only `paid` and `payout_settled` mean the customer has
+                    the money."
+                  example: paid
+                stripe_reference:
+                  type: string
+                  description: The payment provider's own refund id, once one exists.
+                  example: re_3UBIxK2eZvKYlo2C
           description: The refund and where it has got to. Read `vehicle_state` before
             telling a customer they have been refunded.
         operation_kind:
@@ -7308,6 +6265,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7344,7 +6312,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: &a13
+          headers: &a15
             Retry-After:
               description: Seconds to wait before retrying, forwarded verbatim from the
                 upstream service. Absent when the upstream named no interval.
@@ -7438,6 +6406,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7474,7 +6453,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -7569,6 +6548,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7605,7 +6595,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -7699,6 +6689,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7735,7 +6736,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -7828,6 +6829,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7864,7 +6876,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -7953,6 +6965,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -7989,7 +7012,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -8093,10 +7116,15 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
                 status: expired
         "410":
-          description: The offer named in the request is no longer available.
-            **`OFFER_EXPIRED`** — The offer token is no longer in the platform’s
-            cache, so the item cannot be added. Search again and add the item
-            with a fresh token. Offers are short-lived by design.
+          description: The offer named in the request is no longer available, or another
+            resource the request names is gone. Tell the two apart by
+            `error.code`. **`OFFER_EXPIRED`** — The offer token is no longer in
+            the platform’s cache, so the item cannot be added. Search again and
+            add the item with a fresh token. Offers are short-lived by design.
+            **`GONE`** — The resource this request names existed and no longer
+            does. Re-acquire it — search again, or check out again to re-quote —
+            then retry with the new identifier. Repeating this request with the
+            same one cannot succeed.
           content:
             application/json:
               schema:
@@ -8137,7 +7165,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -8228,6 +7256,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -8264,7 +7303,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -8365,6 +7404,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -8401,7 +7451,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -8490,6 +7540,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -8526,7 +7587,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -8628,11 +7689,22 @@ paths:
                 anyOf:
                   - $ref: "#/components/schemas/TripStateResponse"
                   - $ref: "#/components/schemas/ErrorResponse"
-              example: &a14
+              example: &a16
                 error:
                   code: CONFLICT
                   message: This trip is already being checked out; no second checkout was started.
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: The trip is not complete enough to check out. **`BAD_REQUEST`** —
             The request was malformed or failed validation. Fix the request as
@@ -8669,7 +7741,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -8778,7 +7850,18 @@ paths:
                 anyOf:
                   - $ref: "#/components/schemas/TripStateResponse"
                   - $ref: "#/components/schemas/ErrorResponse"
-              example: *a14
+              example: *a16
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: The trip is not complete enough to check out. **`BAD_REQUEST`** —
             The request was malformed or failed validation. Fix the request as
@@ -8815,7 +7898,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -8908,22 +7991,29 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "410":
           description: The locked quote has expired, so nothing was redeemed and no
-            payment object was created. **`QUOTE_EXPIRED`** — The locked quote
-            behind this checkout passed its `expires_at`, so payment was refused
-            before any payment object was created. Call `POST /v1/checkout`
-            again on the same trip — it re-quotes — then mint a new Shared
-            Payment Token against the new `agent_spt_params` and submit that.
-            Nothing was charged.
+            payment object was created — or the resource the request names is
+            gone. Tell the two apart by `error.code`. **`QUOTE_EXPIRED`** — The
+            locked quote behind this checkout passed its `expires_at`, so
+            payment was refused before any payment object was created. Call
+            `POST /v1/checkout` again on the same trip — it re-quotes — then
+            mint a new Shared Payment Token against the new `agent_spt_params`
+            and submit that. Nothing was charged. **`GONE`** — The resource this
+            request names existed and no longer does. Re-acquire it — search
+            again, or check out again to re-quote — then retry with the new
+            identifier. Repeating this request with the same one cannot succeed.
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/QuoteExpiredResponse"
+                anyOf:
+                  - $ref: "#/components/schemas/QuoteExpiredResponse"
+                  - $ref: "#/components/schemas/ErrorResponse"
               example:
                 error:
                   code: QUOTE_EXPIRED
                   message: The quote behind this checkout expired at 2026-09-04T12:39:56Z.
                   doc_url: https://docs.gojinko.com/concepts/errors
                 expires_at: "2026-09-04T12:39:56Z"
+                quoted_cart_id: 2097152
         "422":
           description: Validation error
           content:
@@ -8960,7 +8050,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -9049,6 +8139,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9085,7 +8186,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -9186,6 +8287,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9222,7 +8334,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -9316,6 +8428,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9352,7 +8475,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -9451,6 +8574,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9487,7 +8621,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -9593,6 +8727,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9629,7 +8774,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -9735,6 +8880,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9771,7 +8927,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -9876,6 +9032,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -9912,7 +9079,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -10022,8 +9189,19 @@ paths:
                 $ref: "#/components/schemas/ErrorResponse"
               example:
                 error:
-                  code: CONFLICT
-                  message: an exchange is already in progress for this booking
+                  code: CONFLICT
+                  message: an exchange is already in progress for this booking
+                  doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
                   doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
@@ -10061,7 +9239,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -10173,6 +9351,17 @@ paths:
                   code: CONFLICT
                   message: the exchange preview is out of date — run a new preview and choose
                     again
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -10209,7 +9398,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -10316,6 +9505,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -10352,7 +9552,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -10418,7 +9618,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a15
+            enum: &a17
               - Solo
               - Couple
               - Group
@@ -10429,7 +9629,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a16
+            enum: &a18
               - One-Way
               - Round-Trip
             example: Round-Trip
@@ -10499,7 +9699,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a17
+            enum: &a19
               - country
               - city
             description: "Ranked output granularity: country (default) or city. Applies to
@@ -10571,6 +9771,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -10607,7 +9818,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -10673,14 +9884,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a15
+            enum: *a17
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a16
+            enum: *a18
             example: Round-Trip
           required: false
           name: trip_type
@@ -10748,7 +9959,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a19
             description: "Ranked output granularity: country (default) or city. Applies to
               destination/market (not audience)."
             example: city
@@ -10818,6 +10029,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -10854,7 +10076,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -10926,14 +10148,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a15
+            enum: *a17
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a16
+            enum: *a18
             example: Round-Trip
           required: false
           name: trip_type
@@ -11052,6 +10274,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -11088,7 +10321,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -11166,14 +10399,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a15
+            enum: *a17
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a16
+            enum: *a18
             example: Round-Trip
           required: false
           name: trip_type
@@ -11225,7 +10458,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a18
+            enum: &a20
               - day
               - week
               - month
@@ -11288,6 +10521,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -11324,7 +10568,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -11392,14 +10636,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a15
+            enum: *a17
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a16
+            enum: *a18
             example: Round-Trip
           required: false
           name: trip_type
@@ -11451,7 +10695,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a20
             description: "Bucket size for the returned series: week (default), day, or
               month."
             example: week
@@ -11460,7 +10704,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a19
             description: "Ranked output granularity: country (default) or city. Applies to
               destination/market (not audience)."
             example: city
@@ -11540,6 +10784,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -11576,7 +10831,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -11644,14 +10899,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a15
+            enum: *a17
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a16
+            enum: *a18
             example: Round-Trip
           required: false
           name: trip_type
@@ -11703,7 +10958,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a20
             description: "Bucket size for the returned series: week (default), day, or
               month."
             example: week
@@ -11712,7 +10967,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a19
             description: "Ranked output granularity: country (default) or city. Applies to
               destination/market (not audience)."
             example: city
@@ -11792,6 +11047,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -11828,7 +11094,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -11902,14 +11168,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a15
+            enum: *a17
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a16
+            enum: *a18
             example: Round-Trip
           required: false
           name: trip_type
@@ -11961,7 +11227,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a20
             description: "Bucket size for the returned series: week (default), day, or
               month."
             example: week
@@ -12031,6 +11297,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12067,7 +11344,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -12158,6 +11435,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12194,7 +11482,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -12283,6 +11571,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12319,7 +11618,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -12408,6 +11707,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12444,7 +11754,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -12544,6 +11854,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12580,7 +11901,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -12669,6 +11990,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12705,7 +12037,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -12794,6 +12126,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12830,7 +12173,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -12919,6 +12262,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -12955,7 +12309,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -13044,6 +12398,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13080,7 +12445,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -13191,6 +12556,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13227,7 +12603,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -13338,6 +12714,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13374,7 +12761,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -13502,6 +12889,17 @@ paths:
                     value: 20500
                     currency: USD
                     decimal_places: 2
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13538,7 +12936,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -13646,6 +13044,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13682,7 +13091,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -13802,6 +13211,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -13838,7 +13258,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -13972,6 +13392,17 @@ paths:
                     MANUAL_REQUIRED`; commit again with `manual_ok: true` to
                     hand it to a Jinko agent, then poll the operation."
                 code: manual_required
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14008,7 +13439,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -14120,6 +13551,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14156,7 +13598,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -14249,6 +13691,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14285,7 +13738,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -14368,6 +13821,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14404,7 +13868,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -14495,6 +13959,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14531,7 +14006,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -14621,6 +14096,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14657,7 +14143,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema:
@@ -14750,6 +14236,17 @@ paths:
                   code: CONFLICT
                   message: an exchange is already in progress for this booking
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "410":
+          description: The resource this request names no longer exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: GONE
+                  message: The resource no longer exists.
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "422":
           description: Validation error
           content:
@@ -14786,7 +14283,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a13
+          headers: *a15
           content:
             application/json:
               schema: