> ## Documentation Index
> Fetch the complete documentation index at: https://voyant.travel/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cabin pricing for a cruise sailing

> Resolve live cabin pricing/availability for a specific cruise sailing.



## OpenAPI

````yaml /api-specs/platform-admin.json post /v1/admin/catalog/cruise-sailing-pricing
openapi: 3.1.0
info:
  title: Voyant Admin API
  version: 1.0.0
  description: >-
    The staff-facing /v1/admin/* REST API exposed by the framework modules in
    your deployed Voyant app. Authenticate with a staff session or API token.
    The server URL is your own app domain, not api.voyant.travel.
servers:
  - url: https://{operatorDomain}
    variables:
      operatorDomain:
        default: app.example.com
        description: The domain of your deployed Voyant operator app.
security:
  - bearerAuth: []
tags:
  - name: Accommodations
    description: >-
      Accommodation sourced-content detail authoring. Mounted at
      /v1/admin/accommodations.
  - name: Action ledger
    description: >-
      Auditable action log with approvals, delegations, reversals and relay
      outbox.
  - name: Bookings
    description: >-
      Booking lifecycle, travelers, items, notes, documents and per-booking
      action-ledger.
  - name: Catalog
    description: >-
      Catalog search and the booking engine (quote, book, drafts, holds, orders)
      plus live sourced package/cruise pricing, mounted at /v1/admin/catalog.
  - name: Charters
    description: >-
      Yacht charter catalog: products, voyages, suites, schedules, yachts,
      per-suite and whole-yacht quotes/bookings and MYBA contracts. Mounted at
      /v1/admin/charters.
  - name: CRM
    description: >-
      Relationships domain: people, organizations, contacts, addresses, notes,
      documents, activities, custom fields and customer signals. Mounted at
      /v1/admin/relationships.
  - name: Cruises
    description: >-
      Cruise catalog authoring: cruises, voyage groups, sailings, prices,
      ships/decks/categories/cabins, enrichment programs, search index and
      bookings. Mounted at /v1/admin/cruises.
  - name: Distribution
    description: >-
      Sales-channel distribution: channels, contracts, commission rules, product
      mappings, booking links, inventory allotments, and settlement runs,
      mounted at /v1/admin/distribution.
  - name: Finance
    description: >-
      Invoices, credit notes, payments, payment schedules, guarantees, payment
      sessions, supplier invoices, tax reference data, and finance reports
      (admin surface, mounted at /v1/admin/finance).
  - name: Invitations
    description: >-
      Staff/agent identity records: named contacts, contact points and
      addresses, including entity-scoped variants. Mounted at
      /v1/admin/identity.
  - name: Legal
    description: >-
      Contracts, contract templates, signatures, policies, policy versions,
      policy acceptances, and legal terms (admin surface, mounted at
      /v1/admin/legal).
  - name: Notifications
    description: >-
      Notification templates, deliveries, reminder rules/stages/channels,
      reminder runs and document dispatch. Mounted at /v1/admin/notifications.
  - name: Operations
    description: >-
      Operational supply: availability rules/slots, resources/pools, ground
      transport and facilities.
  - name: Products
    description: >-
      Owned product catalog authoring: products, options, itineraries, media,
      brochures, types, categories, and destinations, mounted at
      /v1/admin/products.
  - name: Promotions
    description: >-
      Promotional offers with discount, scope, conditions, and validity windows,
      mounted at /v1/admin/promotions.
  - name: Quotes
    description: >-
      Sales quotes, quote versions, lines, pipelines and stages plus proposal
      send/snapshot. Mounted at /v1/admin/quotes and /v1/admin/quote-versions.
  - name: Settings
    description: >-
      Operator-tenant settings: profile, payment instructions, payment defaults
      and combined operator settings. Mounted at /v1/admin/settings.
  - name: Storefront
    description: Operator-facing storefront configuration. Mounted at /v1/admin/storefront.
  - name: Trips
    description: >-
      Multi-component trip envelopes: composition, pricing, reservation,
      checkout and snapshots.
  - name: Workflow runs
    description: Read-only workflow run inspection plus trigger, rerun and resume.
paths:
  /v1/admin/catalog/cruise-sailing-pricing:
    post:
      tags:
        - Catalog
      summary: Cabin pricing for a cruise sailing
      description: Resolve live cabin pricing/availability for a specific cruise sailing.
      operationId: getCatalogCruiseSailingPricingAdmin
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - cruiseId
                - sailingRef
              properties:
                cruiseId:
                  type: string
                  minLength: 1
                sailingRef:
                  type: string
                  minLength: 1
      responses:
        '200':
          description: Cabin pricing
          content:
            application/json:
              schema:
                type: object
                properties:
                  cabins:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        fromAmountMinor:
                          type: integer
                          nullable: true
                        available:
                          type: boolean
                  currency:
                    type: string
                    nullable: true
                  retryable:
                    type: boolean
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/ServerError'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl --request POST \
              --url https://app.example.com/v1/admin/catalog/cruise-sailing-pricing \
              --header 'Authorization: Bearer <token>' \
              --header 'Content-Type: application/json' \
              --data '{
              "cruiseId": "<string>",
              "sailingRef": "<string>"
            }'
        - lang: javascript
          label: Node
          source: >-
            const response = await
            fetch("https://app.example.com/v1/admin/catalog/cruise-sailing-pricing",
            {
              method: "POST",
              headers: {
                "Content-Type": "application/json",
                "Authorization": "Bearer <token>"
              },
              body: JSON.stringify({
                "cruiseId": "<string>",
                "sailingRef": "<string>"
              }),
            });


            const data = await response.json();
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.post(
                "https://app.example.com/v1/admin/catalog/cruise-sailing-pricing",
                headers={
                    "Authorization": "Bearer <token>"
                },
                json={
                    "cruiseId": "<string>",
                    "sailingRef": "<string>"
                }
            )

            data = response.json()
components:
  responses:
    BadRequest:
      description: >-
        The request was malformed or failed schema validation (`code:
        invalid_request`).
      headers:
        X-Request-Id:
          description: >-
            Correlation id for this request, echoed on every response including
            errors.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Unauthorized:
      description: 'Authentication is missing or invalid (`code: unauthorized`).'
      headers:
        X-Request-Id:
          description: >-
            Correlation id for this request, echoed on every response including
            errors.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Forbidden:
      description: >-
        The caller is authenticated but not permitted on this surface or lacks
        the required scope (`code: forbidden`).
      headers:
        X-Request-Id:
          description: >-
            Correlation id for this request, echoed on every response including
            errors.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    ServerError:
      description: >-
        An unexpected error occurred. The `X-Request-Id` header identifies the
        failed request.
      headers:
        X-Request-Id:
          description: >-
            Correlation id for this request, echoed on every response including
            errors.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  schemas:
    ApiError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable error message.
        code:
          type: string
          description: >-
            Stable, machine-readable error code (e.g. invalid_request,
            unauthorized, forbidden). Absent for unmapped 500s.
        requestId:
          type: string
          description: >-
            Correlation id for this request. Also returned in the X-Request-Id
            response header.
        details:
          type: object
          additionalProperties: true
          description: >-
            Optional structured context. Validation errors (400) include
            `issues` and `fields` from the failed schema.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Staff session or API token issued by your Voyant app.

````