@gojinko/api-client 2.29.0 → 2.29.2

package/public-api.yaml

@@ -1,10 +1,10 @@
-# synced from jinko-api@7a42e7f9a94e56a9c301186d15d3c00532640284 (7a42e7f9a94e56a9c301186d15d3c00532640284)
+# synced from jinko-api@018822da7b5f2e035baa83aa0a615d7facc2432b (018822d)
 # Vendored copy of the canonical public contract. Do not hand-edit: change it in
 # 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.16.0
+  version: 0.17.0
   description: >-
     Curated public REST surface for Jinko. Authenticated with jnk_ API keys. See
     https://docs.gojinko.com for guides.
@@ -485,6 +485,15 @@ components:
             code:
               type: string
               enum: &a9
+                - credential_format_invalid
+                - payment_type_not_enabled
+                - payment_credential_invalid
+                - trip_owned_by_other_payment
+                - idempotency_key_reused
+                - attempt_in_progress
+                - quote_expired
+                - attempt_terminal
+                - temporarily_unavailable
                 - AUTH_REQUIRED
                 - PAYMENT_REQUIRED
                 - RATE_LIMITED
@@ -2357,6 +2366,132 @@ components:
         trip_id: trip_1048576
         add_item:
           trip_item_token: tok_flt_9f3b2a17
+    PaymentAttemptOutcome:
+      type: object
+      properties:
+        payment_attempt_id:
+          type: string
+        trip_id:
+          type: string
+        quoted_cart_id:
+          type: integer
+        fulfillment_cart_id:
+          type: integer
+        payment_status:
+          type: string
+          enum:
+            - not_started
+            - pending
+            - requires_authentication
+            - authorized
+            - captured
+            - declined
+            - cancelling
+            - cancelled
+            - expired
+            - failed
+        booking_status:
+          type: string
+        booking_ref:
+          type: string
+        payment_error:
+          type: object
+          nullable: true
+          properties:
+            code:
+              type: string
+              enum: &a12
+                - credential_format_invalid
+                - payment_type_not_enabled
+                - payment_credential_invalid
+                - trip_owned_by_other_payment
+                - idempotency_key_reused
+                - attempt_in_progress
+                - card_declined
+                - payment_credential_rejected
+                - authentication_required
+                - authentication_failed
+                - authentication_abandoned
+                - quote_expired
+                - attempt_terminal
+                - payment_outcome_unknown
+                - fulfillment_dispatch_delayed
+                - reconciliation_required
+                - temporarily_unavailable
+            message:
+              type: string
+          required:
+            - code
+            - message
+        recovery:
+          type: object
+          properties:
+            action:
+              type: string
+              enum: &a13
+                - poll
+                - authenticate
+                - retry_same_key
+                - retry_new_key
+                - recheckout
+                - contact_support
+                - stop
+            replacement_credential_required:
+              type: boolean
+          required:
+            - action
+            - replacement_credential_required
+        recovery_status:
+          type: string
+          enum:
+            - automatic
+            - manual_review
+        quote_expires_at:
+          type: string
+          format: date-time
+        retry_after_seconds:
+          type: integer
+        authentication:
+          type: object
+          properties:
+            url:
+              type: string
+            expires_at:
+              type: string
+              format: date-time
+          required:
+            - url
+            - expires_at
+        money:
+          type: object
+          properties:
+            authorized:
+              $ref: "#/components/schemas/Money"
+            captured:
+              $ref: "#/components/schemas/Money"
+            released:
+              $ref: "#/components/schemas/Money"
+            refunded:
+              $ref: "#/components/schemas/Money"
+            externally_reimbursed:
+              $ref: "#/components/schemas/Money"
+            resolution_status:
+              type: string
+              enum:
+                - pending
+                - resolved
+                - manual_review
+            refund_reference:
+              type: string
+      required:
+        - payment_attempt_id
+        - trip_id
+        - quoted_cart_id
+        - payment_status
+        - booking_status
+        - payment_error
+        - recovery
+        - recovery_status
     BookingRef:
       type: object
       properties:
@@ -2409,6 +2544,8 @@ components:
     GetTripResponse:
       type: object
       properties:
+        payment_attempt:
+          $ref: "#/components/schemas/PaymentAttemptOutcome"
         trip_id:
           type: string
           example: trip_1048576
@@ -2635,6 +2772,48 @@ components:
     CheckoutResponse:
       type: object
       properties:
+        quoted_cart_id:
+          type: integer
+        accepted_payment_types:
+          type: array
+          items:
+            type: object
+            properties:
+              type:
+                type: string
+                enum:
+                  - spt
+                  - card
+              card_kinds:
+                type: array
+                items:
+                  type: string
+                  enum:
+                    - customer_card
+                    - vcc
+              requires:
+                type: object
+                properties:
+                  headers:
+                    type: array
+                    items:
+                      type: string
+                  fields:
+                    type: array
+                    items:
+                      type: string
+                required:
+                  - headers
+                  - fields
+              authentication:
+                type: string
+                enum:
+                  - customer_handoff
+                  - unavailable
+            required:
+              - type
+              - requires
+              - authentication
         session_id:
           type: string
           example: cs_1048576
@@ -2682,6 +2861,9 @@ components:
             $ref: "#/components/schemas/TripItem"
         agent_spt_params:
           $ref: "#/components/schemas/AgentSPTParams"
+      required:
+        - quoted_cart_id
+        - accepted_payment_types
     CheckoutRequest:
       type: object
       properties:
@@ -2717,6 +2899,34 @@ components:
           description: Hosted-checkout fallback, present only on a 3DS step-up / decline.
         recap_token:
           type: string
+    PaymentRefusalResponse:
+      allOf:
+        - $ref: "#/components/schemas/ErrorResponse"
+        - type: object
+          properties:
+            payment_error:
+              type: object
+              nullable: true
+              properties:
+                code:
+                  type: string
+                  enum: *a12
+                message:
+                  type: string
+              required:
+                - code
+                - message
+            recovery:
+              type: object
+              properties:
+                action:
+                  type: string
+                  enum: *a13
+                replacement_credential_required:
+                  type: boolean
+              required:
+                - action
+                - replacement_credential_required
     QuoteExpiredResponse:
       type: object
       properties:
@@ -2746,6 +2956,95 @@ components:
           example: 2097152
       required:
         - error
+    TypedAgentPaymentSubmitRequest:
+      type: object
+      properties:
+        trip_id:
+          type: string
+        quoted_cart_id:
+          type: integer
+        payment:
+          oneOf:
+            - type: object
+              properties:
+                type:
+                  type: string
+                  enum:
+                    - spt
+                shared_payment_token:
+                  type: string
+                  minLength: 1
+              required:
+                - type
+                - shared_payment_token
+              additionalProperties: false
+            - type: object
+              properties:
+                type:
+                  type: string
+                  enum:
+                    - card
+                card_kind:
+                  type: string
+                  enum:
+                    - customer_card
+                    - vcc
+                number:
+                  type: string
+                  description: 12–19 digits after removing spaces, with a valid Luhn checksum.
+                    Forwarded unchanged.
+                exp_month:
+                  type: integer
+                  minimum: 1
+                  maximum: 12
+                exp_year:
+                  type: integer
+                  description: Four-digit expiry year, at least the current UTC year.
+                  minimum: 1000
+                  maximum: 9999
+                cvc:
+                  type: string
+                  pattern: ^[0-9]{3,4}$(?![\s\S])
+                billing_details:
+                  type: object
+                  properties:
+                    name:
+                      type: string
+                    email:
+                      type: string
+                      format: email
+                    phone:
+                      type: string
+                    address:
+                      type: object
+                      properties:
+                        line1:
+                          type: string
+                        line2:
+                          type: string
+                        city:
+                          type: string
+                        state:
+                          type: string
+                        postal_code:
+                          type: string
+                        country:
+                          type: string
+                      additionalProperties: false
+                  additionalProperties: false
+              required:
+                - type
+                - card_kind
+                - number
+                - exp_month
+                - exp_year
+                - cvc
+              additionalProperties: false
+      required:
+        - trip_id
+        - quoted_cart_id
+        - payment
+      additionalProperties: false
     AgentPaymentSubmitRequest:
       type: object
       properties:
@@ -4232,13 +4531,13 @@ components:
           type: boolean
         refund_support_level:
           type: string
-          enum: &a12
+          enum: &a14
             - AUTO
             - MANUAL_REQUIRED
             - UNSUPPORTED
         exchange_support_level:
           type: string
-          enum: *a12
+          enum: *a14
         refund_unavailable_reason:
           type: string
         exchange_unavailable_reason:
@@ -4251,7 +4550,7 @@ components:
           type: string
         support_level:
           type: string
-          enum: *a12
+          enum: *a14
       required:
         - can_refund
         - can_void
@@ -4342,7 +4641,7 @@ components:
           $ref: "#/components/schemas/IntentInput"
       required:
         - booking_ref
-      example: &a13
+      example: &a15
         booking_ref: JNK-8PT9VS
         last_name: Carrard
     CarCancelCommitResponse:
@@ -4490,7 +4789,7 @@ components:
           $ref: "#/components/schemas/IntentInput"
       required:
         - booking_ref
-      example: *a13
+      example: *a15
     DestinationSnapshotRow:
       type: object
       properties:
@@ -4883,7 +5182,7 @@ components:
           type: string
         intent:
           $ref: "#/components/schemas/IntentInput"
-      example: &a14
+      example: &a16
         booking_ref: JNK-A0AUR2
         last_name: Carrard
     ServicingState:
@@ -5035,7 +5334,7 @@ components:
           type: string
         intent:
           $ref: "#/components/schemas/IntentInput"
-      example: *a14
+      example: *a16
     RefundStatusResponse:
       type: object
       properties:
@@ -5115,7 +5414,7 @@ components:
           $ref: "#/components/schemas/IntentInput"
         refund_reference:
           type: string
-      example: *a14
+      example: *a16
     ExchangeOffer:
       type: object
       properties:
@@ -5195,7 +5494,7 @@ components:
             nullable: true
         preferred_departure_date:
           type: string
-      example: *a14
+      example: *a16
     ExchangePriceResponse:
       type: object
       properties:
@@ -5411,7 +5710,7 @@ components:
           type: string
         intent:
           $ref: "#/components/schemas/IntentInput"
-      example: *a14
+      example: *a16
     ProviderFigures:
       type: object
       properties:
@@ -6305,7 +6604,7 @@ components:
           deprecated: true
         intent:
           $ref: "#/components/schemas/IntentInput"
-      example: *a14
+      example: *a16
     FlightRefundCommitResponse:
       type: object
       properties:
@@ -6867,7 +7166,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: &a15
+          headers: &a17
             Retry-After:
               description: Seconds to wait before retrying, forwarded verbatim from the
                 upstream service. Absent when the upstream named no interval.
@@ -7025,7 +7324,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -7178,7 +7477,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -7330,7 +7629,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -7481,7 +7780,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -7628,7 +7927,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -7799,7 +8098,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -7952,7 +8251,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -8111,7 +8410,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -8258,7 +8557,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -8378,7 +8677,7 @@ paths:
                 anyOf:
                   - $ref: "#/components/schemas/TripStateResponse"
                   - $ref: "#/components/schemas/ErrorResponse"
-              example: &a16
+              example: &a18
                 error:
                   code: CONFLICT
                   message: This trip is already being checked out; no second checkout was started.
@@ -8436,7 +8735,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -8558,7 +8857,7 @@ paths:
                 anyOf:
                   - $ref: "#/components/schemas/TripStateResponse"
                   - $ref: "#/components/schemas/ErrorResponse"
-              example: *a16
+              example: *a18
         "410":
           description: "The selected offer could not be priced, or another resource the
             request names is gone. Tell the causes apart by `error.code`.
@@ -8612,7 +8911,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -8639,35 +8938,70 @@ paths:
     post:
       tags:
         - Pricing & booking
-      summary: Submit an agent payment — present trip_id + a Shared Payment Token to
-        schedule + authorize the booking; returns a checkout_url fallback if
-        customer action (3DS) is required
+      summary: Submit a typed card or SPT payment with Idempotency-Key, or a legacy
+        flat Shared Payment Token
+      description: "Typed submissions require a jnk_ API key via X-API-Key
+        (ApiKeyAuth) or Authorization: Bearer (BearerAuth), a tenant-bound
+        booking scope, quoted_cart_id and Idempotency-Key, and return a
+        PaymentAttemptOutcome (200 known outcome / 202 pending). OAuth/JWT
+        bearer tokens are supported only for the legacy flat token body, which
+        keeps its existing authorization response. Request bodies are limited to
+        16 KiB."
       security:
         - ApiKeyAuth: []
         - BearerAuth: []
+      parameters:
+        - schema:
+            type: string
+            minLength: 1
+            maxLength: 255
+            pattern: ^[ -~]+$(?![\s\S])
+            description: "Required when payment is present: 1–255 printable ASCII
+              characters. Reuse only for the same payment submission."
+          required: false
+          name: Idempotency-Key
+          in: header
       requestBody:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/AgentPaymentSubmitRequest"
+              anyOf:
+                - $ref: "#/components/schemas/TypedAgentPaymentSubmitRequest"
+                - $ref: "#/components/schemas/AgentPaymentSubmitRequest"
       responses:
         "200":
-          description: Authorization result
+          description: Legacy authorization result or typed payment outcome
+          content:
+            application/json:
+              schema:
+                anyOf:
+                  - $ref: "#/components/schemas/PaymentAttemptOutcome"
+                  - $ref: "#/components/schemas/AgentPaymentSubmitResponse"
+        "202":
+          description: Payment accepted and pending; poll the attempt after Retry-After.
+          headers:
+            Retry-After:
+              schema:
+                type: string
+              description: Polling delay supplied by the BFF.
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AgentPaymentSubmitResponse"
+                $ref: "#/components/schemas/PaymentAttemptOutcome"
         "400":
-          description: Bad request
+          description: Payment credential format or validity refusal.
+            **`credential_format_invalid`** — The typed payment body or
+            Idempotency-Key has an invalid format. Correct the named field and
+            resubmit with a valid Idempotency-Key.
+            **`payment_credential_invalid`** — The payment credential is
+            invalid. Follow recovery.action and supply a replacement credential
+            when required. **`BAD_REQUEST`** — The request was malformed or
+            failed validation. Fix the request as the message describes;
+            retrying it unchanged cannot succeed.
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ErrorResponse"
-              example:
-                error:
-                  code: BAD_REQUEST
-                  message: Malformed JSON in request body.
-                  doc_url: https://docs.gojinko.com/concepts/errors
+                $ref: "#/components/schemas/PaymentRefusalResponse"
         "401":
           description: Authentication required
           content:
@@ -8692,6 +9026,14 @@ paths:
                     has $0.0000 available. Top up at
                     https://dashboard.gojinko.com/developers/billing/topup
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "403":
+          description: This payment type is not enabled. **`payment_type_not_enabled`** —
+            This payment type is not enabled for the caller. Choose a type
+            advertised in accepted_payment_types or contact support.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PaymentRefusalResponse"
         "404":
           description: Resource not found
           content:
@@ -8704,16 +9046,21 @@ paths:
                   message: Resource not found.
                   doc_url: https://docs.gojinko.com/concepts/errors
         "409":
-          description: The operation conflicts with the current state of the resource
+          description: Payment submission conflicts with an existing attempt.
+            **`trip_owned_by_other_payment`** — Another payment attempt owns
+            this trip. Read the existing attempt and follow its recovery action
+            before paying again. **`idempotency_key_reused`** — The idempotency
+            key was already used for a different submission. Reuse the original
+            request with this key, or use a new key for a new submission.
+            **`attempt_in_progress`** — A payment attempt is already in
+            progress. Poll the existing attempt and follow recovery.action.
+            **`attempt_terminal`** — This payment attempt has reached a terminal
+            state. Read its outcome and follow recovery.action before starting
+            another attempt.
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ErrorResponse"
-              example:
-                error:
-                  code: CONFLICT
-                  message: an exchange is already in progress for this booking
-                  doc_url: https://docs.gojinko.com/concepts/errors
+                $ref: "#/components/schemas/PaymentRefusalResponse"
         "410":
           description: The locked quote has expired, so nothing was redeemed and no
             payment object was created — or the resource the request names is
@@ -8726,12 +9073,16 @@ paths:
             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.
+            **`quote_expired`** — The quoted cart has expired; the typed payment
+            was refused. Call checkout again and submit against the new
+            quoted_cart_id.
           content:
             application/json:
               schema:
                 anyOf:
                   - $ref: "#/components/schemas/QuoteExpiredResponse"
                   - $ref: "#/components/schemas/ErrorResponse"
+                  - $ref: "#/components/schemas/PaymentRefusalResponse"
               example:
                 error:
                   code: QUOTE_EXPIRED
@@ -8773,9 +9124,165 @@ paths:
                   message: "sabre-rest BargainFinderMaxRQ failed with status 400: 27131 - Number
                     of connection locations exceeds maximum allowed"
                   doc_url: https://docs.gojinko.com/concepts/errors
+        "503":
+          description: Payment temporarily unavailable. **`temporarily_unavailable`** —
+            Payment submission is temporarily unavailable. Wait for Retry-After
+            when provided and follow recovery.action.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PaymentRefusalResponse"
+        "504":
+          description: The travel provider did not answer in time
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: UPSTREAM_TIMEOUT
+                  message: sabre-rest BargainFinderMaxRQ timed out after 30s
+                  doc_url: https://docs.gojinko.com/concepts/errors
+  /v1/trip/{trip_id}/payment_attempts/{payment_attempt_id}:
+    get:
+      tags:
+        - Pricing & booking
+      summary: Read a payment attempt outcome
+      security:
+        - ApiKeyAuth: []
+        - BearerAuth: []
+      parameters:
+        - schema:
+            type: string
+          required: true
+          name: trip_id
+          in: path
+        - schema:
+            type: string
+          required: true
+          name: payment_attempt_id
+          in: path
+      responses:
+        "200":
+          description: Payment attempt outcome
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PaymentAttemptOutcome"
+        "400":
+          description: Bad request
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: BAD_REQUEST
+                  message: Malformed JSON in request body.
+                  doc_url: https://docs.gojinko.com/concepts/errors
+        "401":
+          description: Authentication required
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: AUTH_REQUIRED
+                  message: Invalid or expired API key.
+                  doc_url: https://docs.gojinko.com/api-reference/authentication
+        "402":
+          description: Payment required — organization balance exhausted
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: PAYMENT_REQUIRED
+                  message: Insufficient balance — this call costs $0.0150 and your organization
+                    has $0.0000 available. Top up at
+                    https://dashboard.gojinko.com/developers/billing/topup
+                  doc_url: https://docs.gojinko.com/concepts/errors
+        "403":
+          description: Payment attempt access forbidden. **`FORBIDDEN`** — The credential
+            is valid, and this request is refused anyway. Do not rotate the key
+            — it is working. Check that it is entitled to this operation, and on
+            this environment.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+        "404":
+          description: Resource not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: NOT_FOUND
+                  message: Resource not found.
+                  doc_url: https://docs.gojinko.com/concepts/errors
+        "409":
+          description: The operation conflicts with the current state of the resource
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  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:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: BAD_REQUEST
+                  message: "origins: origins is required; trip_type: trip_type is required"
+                  doc_url: https://docs.gojinko.com/concepts/errors
+        "429":
+          description: Rate limit or quota exceeded
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: RATE_LIMITED
+                  message: Rate limit or quota exceeded.
+                  doc_url: https://docs.gojinko.com/concepts/errors
+        "502":
+          description: The travel provider rejected the request, or an upstream call failed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+              example:
+                error:
+                  code: UPSTREAM_REJECTED
+                  message: "sabre-rest BargainFinderMaxRQ failed with status 400: 27131 - Number
+                    of connection locations exceeds maximum allowed"
+                  doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -8952,7 +9459,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -9111,7 +9618,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -9263,7 +9770,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -9420,7 +9927,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -9590,7 +10097,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -9762,7 +10269,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -9912,7 +10419,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -9978,7 +10485,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a17
+            enum: &a19
               - Solo
               - Couple
               - Group
@@ -9989,7 +10496,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a18
+            enum: &a20
               - One-Way
               - Round-Trip
             example: Round-Trip
@@ -10059,7 +10566,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a19
+            enum: &a21
               - country
               - city
             description: "Ranked output granularity: country (default) or city. Applies to
@@ -10189,7 +10696,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -10255,14 +10762,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a19
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a20
             example: Round-Trip
           required: false
           name: trip_type
@@ -10330,7 +10837,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a19
+            enum: *a21
             description: "Ranked output granularity: country (default) or city. Applies to
               destination/market (not audience)."
             example: city
@@ -10458,7 +10965,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -10530,14 +11037,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a19
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a20
             example: Round-Trip
           required: false
           name: trip_type
@@ -10714,7 +11221,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -10792,14 +11299,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a19
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a20
             example: Round-Trip
           required: false
           name: trip_type
@@ -10851,7 +11358,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: &a20
+            enum: &a22
               - day
               - week
               - month
@@ -10972,7 +11479,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -11040,14 +11547,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a19
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a20
             example: Round-Trip
           required: false
           name: trip_type
@@ -11099,7 +11606,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a20
+            enum: *a22
             description: "Bucket size for the returned series: week (default), day, or
               month."
             example: week
@@ -11108,7 +11615,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a19
+            enum: *a21
             description: "Ranked output granularity: country (default) or city. Applies to
               destination/market (not audience)."
             example: city
@@ -11246,7 +11753,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -11314,14 +11821,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a19
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a20
             example: Round-Trip
           required: false
           name: trip_type
@@ -11373,7 +11880,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a20
+            enum: *a22
             description: "Bucket size for the returned series: week (default), day, or
               month."
             example: week
@@ -11382,7 +11889,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a19
+            enum: *a21
             description: "Ranked output granularity: country (default) or city. Applies to
               destination/market (not audience)."
             example: city
@@ -11520,7 +12027,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -11594,14 +12101,14 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a17
+            enum: *a19
             example: Couple
           required: false
           name: traveler_type
           in: query
         - schema:
             type: string
-            enum: *a18
+            enum: *a20
             example: Round-Trip
           required: false
           name: trip_type
@@ -11653,7 +12160,7 @@ paths:
           in: query
         - schema:
             type: string
-            enum: *a20
+            enum: *a22
             description: "Bucket size for the returned series: week (default), day, or
               month."
             example: week
@@ -11781,7 +12288,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -11933,7 +12440,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -12083,7 +12590,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -12233,7 +12740,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -12383,7 +12890,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -12533,7 +13040,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -12683,7 +13190,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -12833,7 +13340,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -12983,7 +13490,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -13154,7 +13661,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -13320,7 +13827,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -13497,7 +14004,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -13650,7 +14157,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -13824,7 +14331,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -14007,7 +14514,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -14164,7 +14671,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -14315,7 +14822,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -14456,7 +14963,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -14605,7 +15112,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -14753,7 +15260,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema:
@@ -14904,7 +15411,7 @@ paths:
                   doc_url: https://docs.gojinko.com/concepts/errors
         "503":
           description: No travel provider can serve the request right now
-          headers: *a15
+          headers: *a17
           content:
             application/json:
               schema: