Availability

Getting availability for a product

The first step when making a sale is to check availability. If allowFreesale is set to true on the product then this step is optional, but it is still recommended to detect closures and operational limits.

Availability Calendar Query

post

Returns one availability object per date for calendar rendering over a date range. This endpoint is optimized for faster calendar rendering, but it does not replace POST /availability for booking flow. You must call POST /availability to obtain an availabilityId before creating or reserving a booking.

Body

application/json

Request schema for /availability/calendar.

productIdstringRequired

Product ID or code.

Example: e7cc8bb4-8d1c-4848-8824-5dbedb718681

optionIdstringRequired

Option ID or code. Use DEFAULT only when the product has no options.

Example: 94cdd032-3d32-416d-b0a4-abf8b7495b8b

localDateStartstring · dateRequired

Start of local date range in the product timezone (YYYY-MM-DD).

Example: 2026-05-14

localDateEndstring · dateRequired

End of local date range in the product timezone (YYYY-MM-DD).

Example: 2026-05-21

currencystringOptional

ISO 4217 currency code.

Example: USD

uuidstringOptional

User-submitted UUID field that can be used to uniquely reference this resource and provide idempotency against repeat requests with the same UUID.

Example: 89fe0192-ddcd-430a-b285-e1396a4725d2

offerCodestringOptional

Offer code to evaluate for pricing and eligibility. From capability octo/offers.

Example: SUMMER25

rentalDurationIdstringOptional

Rental duration identifier for rental products. From capability octo/rentals.

Example: rental_duration_2h

Responses

200

Successful response

application/json

availabilityLocalStartTimesstring[]Required

List of availability local start time values.

Example: ["09:00","13:00"]

availablebooleanRequired

Whether this availability can be booked.

Example: true

availableWeightnumber · nullableOptional

Available weight numeric value.

Example: 20

capacityinteger · nullableOptional

Capacity numeric value.

Example: 2

localDatestring · dateRequired

Local date in YYYY-MM-DD format.

Example: 2026-03-01

maxPaxCountinteger · nullableOptional

Max pax count numeric value.

Example: 2

maxUnitsinteger · nullableOptional

Max units numeric value.

Example: 2

maxWeightnumber · nullableOptional

Max weight numeric value.

Example: 20

paxCountintegerOptional

Pax count numeric value.

Example: 2

paxWeightnumberOptional

Pax weight numeric value.

Example: 20

statusstring · enumRequired

Current status value.

Example: AVAILABLEPossible values:

statusMessagestringRequired

Status message value.

Example: Limited availability for this departure.

utcCutoffAtstring · date-timeRequired

Utc cutoff at timestamp in ISO 8601 format.

Example: 2026-05-14T13:00:00Z

utcOnsaleAtstring · date-time · nullableOptional

Utc onsale at timestamp in ISO 8601 format.

Example: 2026-05-14T13:00:00Z

vacanciesinteger · nullableOptional

Vacancies numeric value.

Example: 2

weightUnitstring · nullableOptional

Weight unit for the weight value.

Example: kg

offerCodestring · nullableOptional

From capability octo/offers.

Example: SUMMER25

post

/availability/calendar

HTTPcURLJavaScriptPython

POST /octo/availability/calendar HTTP/1.1
Host: api.ventrata.com
Content-Type: application/json
Accept: */*
Content-Length: 648

{
  "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
  "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
  "localDateStart": "2026-05-14",
  "localDateEnd": "2026-05-21",
  "units": [
    {
      "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
      "quantity": 2,
      "weightValue": 20,
      "weightUnit": "kg"
    }
  ],
  "currency": "USD",
  "uuid": "89fe0192-ddcd-430a-b285-e1396a4725d2",
  "offerCode": "SUMMER25",
  "extras": [
    {
      "id": "f1a5d2e8-8d57-4f0b-9c3f-6a12d7a8bc90",
      "quantity": 2
    }
  ],
  "rentalDurationId": "rental_duration_2h",
  "membership": {
    "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
    "email": "[email protected]",
    "mobile": "[phone]",
    "country": "US",
    "reference": "REF-2026-001",
    "verification": "123456"
  }
}

200

Successful response

[
  {
    "availabilityLocalStartTimes": [
      "09:00",
      "13:00"
    ],
    "available": true,
    "availableWeight": 20,
    "capacity": 2,
    "localDate": "2026-03-01",
    "maxPaxCount": 2,
    "maxUnits": 2,
    "maxWeight": 20,
    "openingHours": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "paxCount": 2,
    "paxWeight": 20,
    "status": "AVAILABLE",
    "statusMessage": "Limited availability for this departure.",
    "utcCutoffAt": "2026-05-14T13:00:00Z",
    "utcOnsaleAt": "2026-05-14T13:00:00Z",
    "vacancies": 2,
    "weightUnit": "kg",
    "extraPricingFrom": [
      {
        "currency": "USD",
        "currencyPrecision": 2,
        "extraId": "extra_fast_track",
        "net": 18000,
        "original": 22000,
        "retail": 20000,
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "original": 2000,
            "retail": 1800,
            "net": 1600
          }
        ],
        "offerDiscount": {
          "retail": 2000,
          "net": 2000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "retail": 200,
              "net": 200
            }
          ]
        }
      }
    ],
    "pricingFrom": {
      "currency": "USD",
      "currencyPrecision": 2,
      "net": 18000,
      "original": 22000,
      "retail": 20000,
      "includedTaxes": [
        {
          "name": "Sales Tax",
          "shortDescription": "Local sales tax",
          "original": 2000,
          "retail": 1800,
          "net": 1600
        }
      ],
      "offerDiscount": {
        "retail": 2000,
        "net": 2000,
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "retail": 200,
            "net": 200
          }
        ]
      }
    },
    "unitPricingFrom": [
      {
        "currency": "USD",
        "currencyPrecision": 2,
        "net": 18000,
        "original": 22000,
        "retail": 20000,
        "unitId": "unit_adult",
        "unitType": "ADULT",
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "original": 2000,
            "retail": 1800,
            "net": 1600
          }
        ],
        "offerDiscount": {
          "retail": 2000,
          "net": 2000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "retail": 200,
              "net": 200
            }
          ]
        }
      }
    ],
    "offer": {
      "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
      "tags": [
        "vip",
        "partner"
      ],
      "title": "Summer Promotion",
      "label": "Save 20%",
      "code": "SUMMER25",
      "description": "20% off selected departures this month.",
      "netDiscount": "FULL",
      "restrictions": {
        "minUnits": 1,
        "maxUnits": 10,
        "minTotal": 0,
        "maxTotal": 50000,
        "unitIds": [
          "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
        ]
      },
      "usable": true,
      "unusableReason": "Offer is not valid for the selected date.",
      "membershipBenefit": {
        "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
        "title": "Summer Promotion",
        "description": "Morning departure with central pickup included."
      }
    },
    "offerCode": "SUMMER25",
    "offers": [
      {
        "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
        "tags": [
          "vip",
          "partner"
        ],
        "title": "Summer Promotion",
        "label": "Save 20%",
        "code": "SUMMER25",
        "description": "20% off selected departures this month.",
        "netDiscount": "FULL",
        "restrictions": {
          "minUnits": 1,
          "maxUnits": 10,
          "minTotal": 0,
          "maxTotal": 50000,
          "unitIds": [
            "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
            "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
          ]
        },
        "usable": true,
        "unusableReason": "Offer is not valid for the selected date.",
        "membershipBenefit": {
          "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
          "title": "Summer Promotion",
          "description": "Morning departure with central pickup included."
        }
      }
    ]
  }
]

Availability Query

post

Returns detailed availability objects per departure time or day. Use this endpoint before booking to obtain the availabilityId required by booking creation/reservation requests.

Body

application/json

Request schema for /availability. productId and optionId are required, and at least one availability selector must be provided (localDate, localDateStart+localDateEnd, availabilityId, or availabilityIds).

productIdstringRequired

Product ID or code.

Example: e7cc8bb4-8d1c-4848-8824-5dbedb718681

optionIdstringRequired

Option ID or code. Use DEFAULT only when the product has no options.

Example: 94cdd032-3d32-416d-b0a4-abf8b7495b8b

availabilityIdstringOptional

Single availability identifier (ISO-8601 local date or date-time).

Example: 2026-05-14T09:00:00-04:00

availabilityIdsstring[]Optional

Multiple availability identifiers.

Example: ["2026-05-14T09:00:00-04:00","2026-05-15T09:00:00-04:00"]

currencystringOptional

ISO 4217 currency code.

Example: USD

localDatestring · dateOptional

Local date in the product timezone (YYYY-MM-DD).

Example: 2026-05-14

localDateEndstring · dateOptional

End of local date range in the product timezone (YYYY-MM-DD).

Example: 2026-05-21

localDateStartstring · dateOptional

Start of local date range in the product timezone (YYYY-MM-DD).

Example: 2026-05-14

localTimestringOptional

Local start time in the product timezone (HH:MM).

Example: 09:00

uuidstringOptional

User-submitted UUID field that can be used to uniquely reference this resource and provide idempotency against repeat requests with the same UUID.

Example: 89fe0192-ddcd-430a-b285-e1396a4725d2

offerCodestringOptional

Offer code to evaluate for pricing and eligibility. From capability octo/offers.

Example: SUMMER25

rentalDurationIdstringOptional

Rental duration identifier for rental products. From capability octo/rentals.

Example: rental_duration_2h

Responses

200

Successful response

application/json

allDaybooleanRequired

Whether all day is enabled.

Example: false

availablebooleanRequired

Whether this availability can be booked.

Example: true

capacityinteger · nullableOptional

Capacity numeric value.

Example: 2

idstring · uuidRequired

Unique identifier for this resource.

Example: 94cdd032-3d32-416d-b0a4-abf8b7495b8b

localDateTimeEndstring · date-timeRequired

Local date time end timestamp in ISO 8601 format.

Example: 2026-03-01T12:00:00-08:00

localDateTimeStartstring · date-timeRequired

Local date time start timestamp in ISO 8601 format.

Example: 2026-03-01T09:00:00-08:00

maxPaxCountinteger · nullableOptional

Max pax count numeric value.

Example: 2

maxUnitsinteger · nullableOptional

Max units numeric value.

Example: 2

paxCountintegerOptional

Pax count numeric value.

Example: 2

referencestring · nullableOptional

Reference value.

Example: REF-2026-001

statusstring · enumRequired

Current status value.

Example: AVAILABLEPossible values:

statusMessagestringRequired

Status message value.

Example: Limited availability for this departure.

utcCutoffAtstring · date-timeRequired

Utc cutoff at timestamp in ISO 8601 format.

Example: 2026-05-14T13:00:00Z

utcOnsaleAtstring · date-time · nullableOptional

Utc onsale at timestamp in ISO 8601 format.

Example: 2026-05-14T13:00:00Z

vacanciesinteger · nullableOptional

Vacancies numeric value.

Example: 2

offerCodestring · nullableOptional

From capability octo/offers.

Example: SUMMER25

dropoffAvailablebooleanOptional

From capability octo/pickups.

Example: true

dropoffRequiredbooleanOptional

From capability octo/pickups.

Example: true

pickupAvailablebooleanOptional

From capability octo/pickups.

Example: true

pickupRequiredbooleanOptional

From capability octo/pickups.

Example: true

hasResourcesbooleanOptional

From capability octo/resources.

Example: true

post

/availability

HTTPcURLJavaScriptPython

POST /octo/availability HTTP/1.1
Host: api.ventrata.com
Content-Type: application/json
Accept: */*
Content-Length: 301

{
  "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
  "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
  "localDate": "2026-05-14",
  "units": [
    {
      "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
      "quantity": 2,
      "weightValue": 20,
      "weightUnit": "kg"
    }
  ],
  "extras": [
    {
      "id": "f1a5d2e8-8d57-4f0b-9c3f-6a12d7a8bc90",
      "quantity": 1
    }
  ]
}

200

Successful response

[
  {
    "allDay": false,
    "available": true,
    "capacity": 2,
    "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
    "localDateTimeEnd": "2026-03-01T12:00:00-08:00",
    "localDateTimeStart": "2026-03-01T09:00:00-08:00",
    "maxPaxCount": 2,
    "maxUnits": 2,
    "openingHours": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "paxCount": 2,
    "reference": "REF-2026-001",
    "status": "AVAILABLE",
    "statusMessage": "Limited availability for this departure.",
    "utcCutoffAt": "2026-05-14T13:00:00Z",
    "utcOnsaleAt": "2026-05-14T13:00:00Z",
    "vacancies": 2,
    "extraPricing": [
      {
        "currency": "USD",
        "currencyPrecision": 2,
        "extraId": "extra_fast_track",
        "net": 18000,
        "original": 22000,
        "retail": 20000,
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "original": 2000,
            "retail": 1800,
            "net": 1600
          }
        ],
        "offerDiscount": {
          "retail": 2000,
          "net": 2000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "retail": 200,
              "net": 200
            }
          ]
        }
      }
    ],
    "pricing": {
      "currency": "USD",
      "currencyPrecision": 2,
      "net": 18000,
      "original": 22000,
      "retail": 20000,
      "includedTaxes": [
        {
          "name": "Sales Tax",
          "shortDescription": "Local sales tax",
          "original": 2000,
          "retail": 1800,
          "net": 1600
        }
      ],
      "offerDiscount": {
        "retail": 2000,
        "net": 2000,
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "retail": 200,
            "net": 200
          }
        ]
      }
    },
    "unitPricing": [
      {
        "currency": "USD",
        "currencyPrecision": 2,
        "net": 18000,
        "original": 22000,
        "retail": 20000,
        "unitId": "unit_adult",
        "unitType": "ADULT",
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "original": 2000,
            "retail": 1800,
            "net": 1600
          }
        ],
        "offerDiscount": {
          "retail": 2000,
          "net": 2000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "retail": 200,
              "net": 200
            }
          ]
        }
      }
    ],
    "offer": {
      "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
      "tags": [
        "vip",
        "partner"
      ],
      "title": "Summer Promotion",
      "label": "Save 20%",
      "code": "SUMMER25",
      "description": "20% off selected departures this month.",
      "netDiscount": "FULL",
      "restrictions": {
        "minUnits": 1,
        "maxUnits": 10,
        "minTotal": 0,
        "maxTotal": 50000,
        "unitIds": [
          "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
        ]
      },
      "usable": true,
      "unusableReason": "Offer is not valid for the selected date.",
      "membershipBenefit": {
        "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
        "title": "Summer Promotion",
        "description": "Morning departure with central pickup included."
      }
    },
    "offerCode": "SUMMER25",
    "offers": [
      {
        "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
        "tags": [
          "vip",
          "partner"
        ],
        "title": "Summer Promotion",
        "label": "Save 20%",
        "code": "SUMMER25",
        "description": "20% off selected departures this month.",
        "netDiscount": "FULL",
        "restrictions": {
          "minUnits": 1,
          "maxUnits": 10,
          "minTotal": 0,
          "maxTotal": 50000,
          "unitIds": [
            "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
            "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
          ]
        },
        "usable": true,
        "unusableReason": "Offer is not valid for the selected date.",
        "membershipBenefit": {
          "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
          "title": "Summer Promotion",
          "description": "Morning departure with central pickup included."
        }
      }
    ],
    "packageAvailabilities": [
      {
        "allDay": false,
        "available": true,
        "capacity": 2,
        "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
        "localDateTimeEnd": "2026-03-01T12:00:00-08:00",
        "localDateTimeStart": "2026-03-01T09:00:00-08:00",
        "maxPaxCount": 2,
        "maxUnits": 2,
        "openingHours": [
          {
            "from": "09:00",
            "to": "17:00"
          }
        ],
        "packageIncludeId": "package_include_id-example",
        "paxCount": 2,
        "reference": "REF-2026-001",
        "status": "AVAILABLE",
        "statusMessage": "Limited availability for this departure.",
        "utcCutoffAt": "2026-05-14T13:00:00Z",
        "utcOnsaleAt": "2026-05-14T13:00:00Z",
        "vacancies": 2,
        "extraPricing": [
          {
            "currency": "USD",
            "currencyPrecision": 2,
            "extraId": "extra_fast_track",
            "net": 18000,
            "original": 22000,
            "retail": 20000,
            "includedTaxes": [
              {
                "name": "Sales Tax",
                "shortDescription": "Local sales tax",
                "original": 2000,
                "retail": 1800,
                "net": 1600
              }
            ],
            "offerDiscount": {
              "retail": 2000,
              "net": 2000,
              "includedTaxes": [
                {
                  "name": "Sales Tax",
                  "shortDescription": "Local sales tax",
                  "retail": 200,
                  "net": 200
                }
              ]
            }
          }
        ],
        "pricing": {
          "currency": "USD",
          "currencyPrecision": 2,
          "net": 18000,
          "original": 22000,
          "retail": 20000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "original": 2000,
              "retail": 1800,
              "net": 1600
            }
          ],
          "offerDiscount": {
            "retail": 2000,
            "net": 2000,
            "includedTaxes": [
              {
                "name": "Sales Tax",
                "shortDescription": "Local sales tax",
                "retail": 200,
                "net": 200
              }
            ]
          }
        },
        "unitPricing": [
          {
            "currency": "USD",
            "currencyPrecision": 2,
            "net": 18000,
            "original": 22000,
            "retail": 20000,
            "unitId": "unit_adult",
            "unitType": "ADULT",
            "includedTaxes": [
              {
                "name": "Sales Tax",
                "shortDescription": "Local sales tax",
                "original": 2000,
                "retail": 1800,
                "net": 1600
              }
            ],
            "offerDiscount": {
              "retail": 2000,
              "net": 2000,
              "includedTaxes": [
                {
                  "name": "Sales Tax",
                  "shortDescription": "Local sales tax",
                  "retail": 200,
                  "net": 200
                }
              ]
            }
          }
        ],
        "offer": {
          "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
          "tags": [
            "vip",
            "partner"
          ],
          "title": "Summer Promotion",
          "label": "Save 20%",
          "code": "SUMMER25",
          "description": "20% off selected departures this month.",
          "netDiscount": "FULL",
          "restrictions": {
            "minUnits": 1,
            "maxUnits": 10,
            "minTotal": 0,
            "maxTotal": 50000,
            "unitIds": [
              "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
              "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
            ]
          },
          "usable": true,
          "unusableReason": "Offer is not valid for the selected date.",
          "membershipBenefit": {
            "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
            "title": "Summer Promotion",
            "description": "Morning departure with central pickup included."
          }
        },
        "offerCode": "SUMMER25",
        "offers": [
          {
            "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
            "tags": [
              "vip",
              "partner"
            ],
            "title": "Summer Promotion",
            "label": "Save 20%",
            "code": "SUMMER25",
            "description": "20% off selected departures this month.",
            "netDiscount": "FULL",
            "restrictions": {
              "minUnits": 1,
              "maxUnits": 10,
              "minTotal": 0,
              "maxTotal": 50000,
              "unitIds": [
                "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
                "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
              ]
            },
            "usable": true,
            "unusableReason": "Offer is not valid for the selected date.",
            "membershipBenefit": {
              "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
              "title": "Summer Promotion",
              "description": "Morning departure with central pickup included."
            }
          }
        ],
        "packageAvailabilities": [
          {
            "allDay": false,
            "available": true,
            "capacity": 2,
            "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
            "localDateTimeEnd": "2026-03-01T12:00:00-08:00",
            "localDateTimeStart": "2026-03-01T09:00:00-08:00",
            "maxPaxCount": 2,
            "maxUnits": 2,
            "openingHours": [
              {
                "from": "09:00",
                "to": "17:00"
              }
            ],
            "packageIncludeId": "package_include_id-example",
            "paxCount": 2,
            "reference": "REF-2026-001",
            "status": "AVAILABLE",
            "statusMessage": "Limited availability for this departure.",
            "utcCutoffAt": "2026-05-14T13:00:00Z",
            "utcOnsaleAt": "2026-05-14T13:00:00Z",
            "vacancies": 2,
            "extraPricing": [
              {
                "currency": "USD",
                "currencyPrecision": 2,
                "extraId": "extra_fast_track",
                "net": 18000,
                "original": 22000,
                "retail": 20000,
                "includedTaxes": [
                  {
                    "name": "Sales Tax",
                    "shortDescription": "Local sales tax",
                    "original": 2000,
                    "retail": 1800,
                    "net": 1600
                  }
                ],
                "offerDiscount": {
                  "retail": 2000,
                  "net": 2000,
                  "includedTaxes": [
                    {
                      "name": "Sales Tax",
                      "shortDescription": "Local sales tax",
                      "retail": 200,
                      "net": 200
                    }
                  ]
                }
              }
            ],
            "pricing": {
              "currency": "USD",
              "currencyPrecision": 2,
              "net": 18000,
              "original": 22000,
              "retail": 20000,
              "includedTaxes": [
                {
                  "name": "Sales Tax",
                  "shortDescription": "Local sales tax",
                  "original": 2000,
                  "retail": 1800,
                  "net": 1600
                }
              ],
              "offerDiscount": {
                "retail": 2000,
                "net": 2000,
                "includedTaxes": [
                  {
                    "name": "Sales Tax",
                    "shortDescription": "Local sales tax",
                    "retail": 200,
                    "net": 200
                  }
                ]
              }
            },
            "unitPricing": [
              {
                "currency": "USD",
                "currencyPrecision": 2,
                "net": 18000,
                "original": 22000,
                "retail": 20000,
                "unitId": "unit_adult",
                "unitType": "ADULT",
                "includedTaxes": [
                  {
                    "name": "Sales Tax",
                    "shortDescription": "Local sales tax",
                    "original": 2000,
                    "retail": 1800,
                    "net": 1600
                  }
                ],
                "offerDiscount": {
                  "retail": 2000,
                  "net": 2000,
                  "includedTaxes": [
                    {
                      "name": "Sales Tax",
                      "shortDescription": "Local sales tax",
                      "retail": 200,
                      "net": 200
                    }
                  ]
                }
              }
            ],
            "offer": {
              "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
              "tags": [
                "vip",
                "partner"
              ],
              "title": "Summer Promotion",
              "label": "Save 20%",
              "code": "SUMMER25",
              "description": "20% off selected departures this month.",
              "netDiscount": "FULL",
              "restrictions": {
                "minUnits": 1,
                "maxUnits": 10,
                "minTotal": 0,
                "maxTotal": 50000,
                "unitIds": [
                  "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
                  "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
                ]
              },
              "usable": true,
              "unusableReason": "Offer is not valid for the selected date.",
              "membershipBenefit": {
                "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
                "title": "Summer Promotion",
                "description": "Morning departure with central pickup included."
              }
            },
            "offerCode": "SUMMER25",
            "offers": [
              {
                "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
                "tags": [
                  "vip",
                  "partner"
                ],
                "title": "Summer Promotion",
                "label": "Save 20%",
                "code": "SUMMER25",
                "description": "20% off selected departures this month.",
                "netDiscount": "FULL",
                "restrictions": {
                  "minUnits": 1,
                  "maxUnits": 10,
                  "minTotal": 0,
                  "maxTotal": 50000,
                  "unitIds": [
                    "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
                    "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
                  ]
                },
                "usable": true,
                "unusableReason": "Offer is not valid for the selected date.",
                "membershipBenefit": {
                  "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
                  "title": "Summer Promotion",
                  "description": "Morning departure with central pickup included."
                }
              }
            ],
            "packageAvailabilities": "[Circular Reference]",
            "dropoffAvailable": true,
            "dropoffDispatch": {
              "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
              "name": "Morning City Tour",
              "phoneNumber": "[phone]",
              "vehicle": "coach_12"
            },
            "dropoffPoints": [
              {
                "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
                "title": "Summer Promotion",
                "description": "Morning departure with central pickup included.",
                "localDateTime": "2026-05-14",
                "localDateTimeTo": "2026-05-14",
                "latitude": 10,
                "longitude": 10,
                "address": "123 Main St, San Francisco, CA",
                "googlePlaceId": "google_place_id-example"
              }
            ],
            "dropoffRequired": true,
            "pickupAvailable": true,
            "pickupDispatch": {
              "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
              "name": "Morning City Tour",
              "phoneNumber": "[phone]",
              "vehicle": "coach_12"
            },
            "pickupPoints": [
              {
                "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
                "title": "Summer Promotion",
                "description": "Morning departure with central pickup included.",
                "localDateTime": "2026-05-14",
                "localDateTimeTo": "2026-05-14",
                "latitude": 10,
                "longitude": 10,
                "address": "123 Main St, San Francisco, CA",
                "googlePlaceId": "google_place_id-example"
              }
            ],
            "pickupRequired": true,
            "hasResources": true,
            "mappings": [
              {
                "resellerReference": "RES-BOOK-10045",
                "resellerStatus": "CONFIRMED",
                "resellerProduct": "grand-canyon-day-tour",
                "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
                "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
                "unitId": "unit_adult",
                "optionRequired": true,
                "unitRequired": true,
                "validityDays": 2,
                "webhookUrl": "https://www.city-sightseeing.com"
              }
            ]
          }
        ],
        "dropoffAvailable": true,
        "dropoffDispatch": {
          "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "name": "Morning City Tour",
          "phoneNumber": "[phone]",
          "vehicle": "coach_12"
        },
        "dropoffPoints": [
          {
            "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
            "title": "Summer Promotion",
            "description": "Morning departure with central pickup included.",
            "localDateTime": "2026-05-14",
            "localDateTimeTo": "2026-05-14",
            "latitude": 10,
            "longitude": 10,
            "address": "123 Main St, San Francisco, CA",
            "googlePlaceId": "google_place_id-example"
          }
        ],
        "dropoffRequired": true,
        "pickupAvailable": true,
        "pickupDispatch": {
          "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "name": "Morning City Tour",
          "phoneNumber": "[phone]",
          "vehicle": "coach_12"
        },
        "pickupPoints": [
          {
            "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
            "title": "Summer Promotion",
            "description": "Morning departure with central pickup included.",
            "localDateTime": "2026-05-14",
            "localDateTimeTo": "2026-05-14",
            "latitude": 10,
            "longitude": 10,
            "address": "123 Main St, San Francisco, CA",
            "googlePlaceId": "google_place_id-example"
          }
        ],
        "pickupRequired": true,
        "hasResources": true,
        "mappings": [
          {
            "resellerReference": "RES-BOOK-10045",
            "resellerStatus": "CONFIRMED",
            "resellerProduct": "grand-canyon-day-tour",
            "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
            "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
            "unitId": "unit_adult",
            "optionRequired": true,
            "unitRequired": true,
            "validityDays": 2,
            "webhookUrl": "https://www.city-sightseeing.com"
          }
        ]
      }
    ],
    "dropoffAvailable": true,
    "dropoffDispatch": {
      "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
      "name": "Morning City Tour",
      "phoneNumber": "[phone]",
      "vehicle": "coach_12"
    },
    "dropoffPoints": [
      {
        "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
        "title": "Summer Promotion",
        "description": "Morning departure with central pickup included.",
        "localDateTime": "2026-05-14",
        "localDateTimeTo": "2026-05-14",
        "latitude": 10,
        "longitude": 10,
        "address": "123 Main St, San Francisco, CA",
        "googlePlaceId": "google_place_id-example"
      }
    ],
    "dropoffRequired": true,
    "pickupAvailable": true,
    "pickupDispatch": {
      "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
      "name": "Morning City Tour",
      "phoneNumber": "[phone]",
      "vehicle": "coach_12"
    },
    "pickupPoints": [
      {
        "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
        "title": "Summer Promotion",
        "description": "Morning departure with central pickup included.",
        "localDateTime": "2026-05-14",
        "localDateTimeTo": "2026-05-14",
        "latitude": 10,
        "longitude": 10,
        "address": "123 Main St, San Francisco, CA",
        "googlePlaceId": "google_place_id-example"
      }
    ],
    "pickupRequired": true,
    "hasResources": true,
    "mappings": [
      {
        "resellerReference": "RES-BOOK-10045",
        "resellerStatus": "CONFIRMED",
        "resellerProduct": "grand-canyon-day-tour",
        "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
        "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
        "unitId": "unit_adult",
        "optionRequired": true,
        "unitRequired": true,
        "validityDays": 2,
        "webhookUrl": "https://www.city-sightseeing.com"
      }
    ]
  }
]

Batch Availability Calendar Query

post

Returns calendar availability across multiple products/options. Designed for background batch jobs and back-office processing, not realtime client requests. For realtime calendar UX use POST /availability/calendar, then call POST /availability to obtain the availabilityId required for booking.

Body

application/json

Request schema for /availability/calendar/batch. Includes the same selectors as /availability/calendar, with optional product filters.

localDateStartstring · dateRequired

Start local date in YYYY-MM-DD format.

Example: 2026-05-14

localDateEndstring · dateRequired

End local date in YYYY-MM-DD format.

Example: 2026-05-21

productIdsstring[]Optional

Optional multi-product filter.

Example: ["e7cc8bb4-8d1c-4848-8824-5dbedb718681","prod_london_hop_on_hop_off"]

currencystringOptional

ISO 4217 currency code.

Example: USD

uuidstringOptional

User-submitted UUID field that can be used to uniquely reference this resource and provide idempotency against repeat requests with the same UUID.

Example: 89fe0192-ddcd-430a-b285-e1396a4725d2

offerCodestringOptional

From capability octo/offers.

Example: SUMMER25

rentalDurationIdstringOptional

From capability octo/rentals.

Example: rental_duration_2h

Responses

200

Successful response

application/json

availabilityLocalStartTimesstring[]Required

List of availability local start time values.

Example: ["09:00","13:00"]

availablebooleanRequired

Whether this availability can be booked.

Example: true

availableWeightnumber · nullableOptional

Available weight numeric value.

Example: 20

capacityinteger · nullableOptional

Capacity numeric value.

Example: 2

localDatestring · dateRequired

Local date in YYYY-MM-DD format.

Example: 2026-03-01

maxPaxCountinteger · nullableOptional

Max pax count numeric value.

Example: 2

maxUnitsinteger · nullableOptional

Max units numeric value.

Example: 2

maxWeightnumber · nullableOptional

Max weight numeric value.

Example: 20

optionIdstringRequired

Option identifier.

Example: 94cdd032-3d32-416d-b0a4-abf8b7495b8b

paxCountintegerOptional

Pax count numeric value.

Example: 2

paxWeightnumberOptional

Pax weight numeric value.

Example: 20

productIdstringRequired

Product identifier.

Example: e7cc8bb4-8d1c-4848-8824-5dbedb718681

statusstring · enumRequired

Current status value.

Example: AVAILABLEPossible values:

statusMessagestringRequired

Status message value.

Example: Limited availability for this departure.

utcCutoffAtstring · date-timeRequired

Utc cutoff at timestamp in ISO 8601 format.

Example: 2026-05-14T13:00:00Z

utcOnsaleAtstring · date-time · nullableOptional

Utc onsale at timestamp in ISO 8601 format.

Example: 2026-05-14T13:00:00Z

vacanciesinteger · nullableOptional

Vacancies numeric value.

Example: 2

weightUnitstring · nullableOptional

Weight unit for the weight value.

Example: kg

offerCodestring · nullableOptional

From capability octo/offers.

Example: SUMMER25

post

/availability/calendar/batch

HTTPcURLJavaScriptPython

POST /octo/availability/calendar/batch HTTP/1.1
Host: api.ventrata.com
Content-Type: application/json
Accept: */*
Content-Length: 630

{
  "localDateStart": "2026-05-14",
  "localDateEnd": "2026-05-21",
  "productIds": [
    "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
    "prod_london_hop_on_hop_off"
  ],
  "units": [
    {
      "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
      "quantity": 2,
      "weightValue": 20,
      "weightUnit": "kg"
    }
  ],
  "currency": "USD",
  "uuid": "89fe0192-ddcd-430a-b285-e1396a4725d2",
  "offerCode": "SUMMER25",
  "extras": [
    {
      "id": "f1a5d2e8-8d57-4f0b-9c3f-6a12d7a8bc90",
      "quantity": 2
    }
  ],
  "rentalDurationId": "rental_duration_2h",
  "membership": {
    "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
    "email": "[email protected]",
    "mobile": "[phone]",
    "country": "US",
    "reference": "REF-2026-001",
    "verification": "123456"
  }
}

200

Successful response

[
  {
    "availabilityLocalStartTimes": [
      "09:00",
      "13:00"
    ],
    "available": true,
    "availableWeight": 20,
    "capacity": 2,
    "localDate": "2026-03-01",
    "maxPaxCount": 2,
    "maxUnits": 2,
    "maxWeight": 20,
    "openingHours": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
    "paxCount": 2,
    "paxWeight": 20,
    "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
    "status": "AVAILABLE",
    "statusMessage": "Limited availability for this departure.",
    "utcCutoffAt": "2026-05-14T13:00:00Z",
    "utcOnsaleAt": "2026-05-14T13:00:00Z",
    "vacancies": 2,
    "weightUnit": "kg",
    "extraPricingFrom": [
      {
        "currency": "USD",
        "currencyPrecision": 2,
        "extraId": "extra_fast_track",
        "net": 18000,
        "original": 22000,
        "retail": 20000,
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "original": 2000,
            "retail": 1800,
            "net": 1600
          }
        ],
        "offerDiscount": {
          "retail": 2000,
          "net": 2000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "retail": 200,
              "net": 200
            }
          ]
        }
      }
    ],
    "pricingFrom": {
      "currency": "USD",
      "currencyPrecision": 2,
      "net": 18000,
      "original": 22000,
      "retail": 20000,
      "includedTaxes": [
        {
          "name": "Sales Tax",
          "shortDescription": "Local sales tax",
          "original": 2000,
          "retail": 1800,
          "net": 1600
        }
      ],
      "offerDiscount": {
        "retail": 2000,
        "net": 2000,
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "retail": 200,
            "net": 200
          }
        ]
      }
    },
    "unitPricingFrom": [
      {
        "currency": "USD",
        "currencyPrecision": 2,
        "net": 18000,
        "original": 22000,
        "retail": 20000,
        "unitId": "unit_adult",
        "unitType": "ADULT",
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "original": 2000,
            "retail": 1800,
            "net": 1600
          }
        ],
        "offerDiscount": {
          "retail": 2000,
          "net": 2000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "retail": 200,
              "net": 200
            }
          ]
        }
      }
    ],
    "offer": {
      "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
      "tags": [
        "vip",
        "partner"
      ],
      "title": "Summer Promotion",
      "label": "Save 20%",
      "code": "SUMMER25",
      "description": "20% off selected departures this month.",
      "netDiscount": "FULL",
      "restrictions": {
        "minUnits": 1,
        "maxUnits": 10,
        "minTotal": 0,
        "maxTotal": 50000,
        "unitIds": [
          "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
        ]
      },
      "usable": true,
      "unusableReason": "Offer is not valid for the selected date.",
      "membershipBenefit": {
        "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
        "title": "Summer Promotion",
        "description": "Morning departure with central pickup included."
      }
    },
    "offerCode": "SUMMER25",
    "offers": [
      {
        "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
        "tags": [
          "vip",
          "partner"
        ],
        "title": "Summer Promotion",
        "label": "Save 20%",
        "code": "SUMMER25",
        "description": "20% off selected departures this month.",
        "netDiscount": "FULL",
        "restrictions": {
          "minUnits": 1,
          "maxUnits": 10,
          "minTotal": 0,
          "maxTotal": 50000,
          "unitIds": [
            "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
            "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
          ]
        },
        "usable": true,
        "unusableReason": "Offer is not valid for the selected date.",
        "membershipBenefit": {
          "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
          "title": "Summer Promotion",
          "description": "Morning departure with central pickup included."
        }
      }
    ]
  }
]

Batch Availability Query

post

Returns detailed availability across multiple products and options. Designed for background batch jobs and back-office processing, not realtime client requests. For realtime client requests use POST /availability.

Body

application/json

Request schema for /availability/batch. Includes the same selectors as /availability, with optional product filters.

availabilityIdstringOptional

Single availability identifier (ISO-8601 local date or date-time).

Example: 2026-05-14T09:00:00-04:00

availabilityIdsstring[]Optional

Multiple availability identifiers.

Example: ["2026-05-14T09:00:00-04:00","2026-05-15T09:00:00-04:00"]

currencystringOptional

ISO 4217 currency code.

Example: USD

localDatestring · dateOptional

Local date in the product timezone (YYYY-MM-DD).

Example: 2026-05-14

localDateEndstring · dateOptional

End of local date range in the product timezone (YYYY-MM-DD).

Example: 2026-05-21

localDateStartstring · dateOptional

Start of local date range in the product timezone (YYYY-MM-DD).

Example: 2026-05-14

localTimestringOptional

Local start time in the product timezone (HH:MM).

Example: 09:00

productIdsstring[]Optional

Optional multi-product filter.

Example: ["e7cc8bb4-8d1c-4848-8824-5dbedb718681","prod_london_hop_on_hop_off"]

uuidstringOptional

User-submitted UUID field that can be used to uniquely reference this resource and provide idempotency against repeat requests with the same UUID.

Example: 89fe0192-ddcd-430a-b285-e1396a4725d2

offerCodestringOptional

Offer code to evaluate for pricing and eligibility. From capability octo/offers.

Example: SUMMER25

rentalDurationIdstringOptional

Rental duration identifier for rental products. From capability octo/rentals.

Example: rental_duration_2h

Responses

200

Successful response

application/json

allDaybooleanRequired

Whether all day is enabled.

Example: false

availablebooleanRequired

Whether this availability can be booked.

Example: true

capacityinteger · nullableOptional

Capacity numeric value.

Example: 2

idstring · uuidRequired

Unique identifier for this resource.

Example: 94cdd032-3d32-416d-b0a4-abf8b7495b8b

localDateTimeEndstring · date-timeRequired

Local date time end timestamp in ISO 8601 format.

Example: 2026-03-01T12:00:00-08:00

localDateTimeStartstring · date-timeRequired

Local date time start timestamp in ISO 8601 format.

Example: 2026-03-01T09:00:00-08:00

maxPaxCountinteger · nullableOptional

Max pax count numeric value.

Example: 2

maxUnitsinteger · nullableOptional

Max units numeric value.

Example: 2

optionIdstringRequired

Option identifier.

Example: 94cdd032-3d32-416d-b0a4-abf8b7495b8b

paxCountintegerOptional

Pax count numeric value.

Example: 2

productIdstringRequired

Product identifier.

Example: e7cc8bb4-8d1c-4848-8824-5dbedb718681

referencestring · nullableOptional

Reference value.

Example: REF-2026-001

statusstring · enumRequired

Current status value.

Example: AVAILABLEPossible values:

statusMessagestringRequired

Status message value.

Example: Limited availability for this departure.

utcCutoffAtstring · date-timeRequired

Utc cutoff at timestamp in ISO 8601 format.

Example: 2026-05-14T13:00:00Z

utcOnsaleAtstring · date-time · nullableOptional

Utc onsale at timestamp in ISO 8601 format.

Example: 2026-05-14T13:00:00Z

vacanciesinteger · nullableOptional

Vacancies numeric value.

Example: 2

offerCodestring · nullableOptional

From capability octo/offers.

Example: SUMMER25

dropoffAvailablebooleanOptional

From capability octo/pickups.

Example: true

dropoffRequiredbooleanOptional

From capability octo/pickups.

Example: true

pickupAvailablebooleanOptional

From capability octo/pickups.

Example: true

pickupRequiredbooleanOptional

From capability octo/pickups.

Example: true

hasResourcesbooleanOptional

From capability octo/resources.

Example: true

post

/availability/batch

HTTPcURLJavaScriptPython

POST /octo/availability/batch HTTP/1.1
Host: api.ventrata.com
Content-Type: application/json
Accept: */*
Content-Length: 796

{
  "availabilityId": "2026-05-14T09:00:00-04:00",
  "availabilityIds": [
    "2026-05-14T09:00:00-04:00",
    "2026-05-15T09:00:00-04:00"
  ],
  "currency": "USD",
  "localDate": "2026-05-14",
  "localDateEnd": "2026-05-21",
  "localDateStart": "2026-05-14",
  "localTime": "09:00",
  "productIds": [
    "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
    "prod_london_hop_on_hop_off"
  ],
  "units": [
    {
      "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
      "quantity": 2,
      "weightValue": 20,
      "weightUnit": "kg"
    }
  ],
  "uuid": "89fe0192-ddcd-430a-b285-e1396a4725d2",
  "offerCode": "SUMMER25",
  "extras": [
    {
      "id": "f1a5d2e8-8d57-4f0b-9c3f-6a12d7a8bc90",
      "quantity": 2
    }
  ],
  "rentalDurationId": "rental_duration_2h",
  "membership": {
    "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
    "email": "[email protected]",
    "mobile": "[phone]",
    "country": "US",
    "reference": "REF-2026-001",
    "verification": "123456"
  }
}

200

Successful response

[
  {
    "allDay": false,
    "available": true,
    "capacity": 2,
    "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
    "localDateTimeEnd": "2026-03-01T12:00:00-08:00",
    "localDateTimeStart": "2026-03-01T09:00:00-08:00",
    "maxPaxCount": 2,
    "maxUnits": 2,
    "openingHours": [
      {
        "from": "09:00",
        "to": "17:00"
      }
    ],
    "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
    "paxCount": 2,
    "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
    "reference": "REF-2026-001",
    "status": "AVAILABLE",
    "statusMessage": "Limited availability for this departure.",
    "utcCutoffAt": "2026-05-14T13:00:00Z",
    "utcOnsaleAt": "2026-05-14T13:00:00Z",
    "vacancies": 2,
    "extraPricing": [
      {
        "currency": "USD",
        "currencyPrecision": 2,
        "extraId": "extra_fast_track",
        "net": 18000,
        "original": 22000,
        "retail": 20000,
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "original": 2000,
            "retail": 1800,
            "net": 1600
          }
        ],
        "offerDiscount": {
          "retail": 2000,
          "net": 2000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "retail": 200,
              "net": 200
            }
          ]
        }
      }
    ],
    "pricing": {
      "currency": "USD",
      "currencyPrecision": 2,
      "net": 18000,
      "original": 22000,
      "retail": 20000,
      "includedTaxes": [
        {
          "name": "Sales Tax",
          "shortDescription": "Local sales tax",
          "original": 2000,
          "retail": 1800,
          "net": 1600
        }
      ],
      "offerDiscount": {
        "retail": 2000,
        "net": 2000,
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "retail": 200,
            "net": 200
          }
        ]
      }
    },
    "unitPricing": [
      {
        "currency": "USD",
        "currencyPrecision": 2,
        "net": 18000,
        "original": 22000,
        "retail": 20000,
        "unitId": "unit_adult",
        "unitType": "ADULT",
        "includedTaxes": [
          {
            "name": "Sales Tax",
            "shortDescription": "Local sales tax",
            "original": 2000,
            "retail": 1800,
            "net": 1600
          }
        ],
        "offerDiscount": {
          "retail": 2000,
          "net": 2000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "retail": 200,
              "net": 200
            }
          ]
        }
      }
    ],
    "offer": {
      "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
      "tags": [
        "vip",
        "partner"
      ],
      "title": "Summer Promotion",
      "label": "Save 20%",
      "code": "SUMMER25",
      "description": "20% off selected departures this month.",
      "netDiscount": "FULL",
      "restrictions": {
        "minUnits": 1,
        "maxUnits": 10,
        "minTotal": 0,
        "maxTotal": 50000,
        "unitIds": [
          "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
        ]
      },
      "usable": true,
      "unusableReason": "Offer is not valid for the selected date.",
      "membershipBenefit": {
        "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
        "title": "Summer Promotion",
        "description": "Morning departure with central pickup included."
      }
    },
    "offerCode": "SUMMER25",
    "offers": [
      {
        "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
        "tags": [
          "vip",
          "partner"
        ],
        "title": "Summer Promotion",
        "label": "Save 20%",
        "code": "SUMMER25",
        "description": "20% off selected departures this month.",
        "netDiscount": "FULL",
        "restrictions": {
          "minUnits": 1,
          "maxUnits": 10,
          "minTotal": 0,
          "maxTotal": 50000,
          "unitIds": [
            "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
            "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
          ]
        },
        "usable": true,
        "unusableReason": "Offer is not valid for the selected date.",
        "membershipBenefit": {
          "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
          "title": "Summer Promotion",
          "description": "Morning departure with central pickup included."
        }
      }
    ],
    "packageAvailabilities": [
      {
        "allDay": false,
        "available": true,
        "capacity": 2,
        "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
        "localDateTimeEnd": "2026-03-01T12:00:00-08:00",
        "localDateTimeStart": "2026-03-01T09:00:00-08:00",
        "maxPaxCount": 2,
        "maxUnits": 2,
        "openingHours": [
          {
            "from": "09:00",
            "to": "17:00"
          }
        ],
        "packageIncludeId": "package_include_id-example",
        "paxCount": 2,
        "reference": "REF-2026-001",
        "status": "AVAILABLE",
        "statusMessage": "Limited availability for this departure.",
        "utcCutoffAt": "2026-05-14T13:00:00Z",
        "utcOnsaleAt": "2026-05-14T13:00:00Z",
        "vacancies": 2,
        "extraPricing": [
          {
            "currency": "USD",
            "currencyPrecision": 2,
            "extraId": "extra_fast_track",
            "net": 18000,
            "original": 22000,
            "retail": 20000,
            "includedTaxes": [
              {
                "name": "Sales Tax",
                "shortDescription": "Local sales tax",
                "original": 2000,
                "retail": 1800,
                "net": 1600
              }
            ],
            "offerDiscount": {
              "retail": 2000,
              "net": 2000,
              "includedTaxes": [
                {
                  "name": "Sales Tax",
                  "shortDescription": "Local sales tax",
                  "retail": 200,
                  "net": 200
                }
              ]
            }
          }
        ],
        "pricing": {
          "currency": "USD",
          "currencyPrecision": 2,
          "net": 18000,
          "original": 22000,
          "retail": 20000,
          "includedTaxes": [
            {
              "name": "Sales Tax",
              "shortDescription": "Local sales tax",
              "original": 2000,
              "retail": 1800,
              "net": 1600
            }
          ],
          "offerDiscount": {
            "retail": 2000,
            "net": 2000,
            "includedTaxes": [
              {
                "name": "Sales Tax",
                "shortDescription": "Local sales tax",
                "retail": 200,
                "net": 200
              }
            ]
          }
        },
        "unitPricing": [
          {
            "currency": "USD",
            "currencyPrecision": 2,
            "net": 18000,
            "original": 22000,
            "retail": 20000,
            "unitId": "unit_adult",
            "unitType": "ADULT",
            "includedTaxes": [
              {
                "name": "Sales Tax",
                "shortDescription": "Local sales tax",
                "original": 2000,
                "retail": 1800,
                "net": 1600
              }
            ],
            "offerDiscount": {
              "retail": 2000,
              "net": 2000,
              "includedTaxes": [
                {
                  "name": "Sales Tax",
                  "shortDescription": "Local sales tax",
                  "retail": 200,
                  "net": 200
                }
              ]
            }
          }
        ],
        "offer": {
          "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
          "tags": [
            "vip",
            "partner"
          ],
          "title": "Summer Promotion",
          "label": "Save 20%",
          "code": "SUMMER25",
          "description": "20% off selected departures this month.",
          "netDiscount": "FULL",
          "restrictions": {
            "minUnits": 1,
            "maxUnits": 10,
            "minTotal": 0,
            "maxTotal": 50000,
            "unitIds": [
              "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
              "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
            ]
          },
          "usable": true,
          "unusableReason": "Offer is not valid for the selected date.",
          "membershipBenefit": {
            "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
            "title": "Summer Promotion",
            "description": "Morning departure with central pickup included."
          }
        },
        "offerCode": "SUMMER25",
        "offers": [
          {
            "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
            "tags": [
              "vip",
              "partner"
            ],
            "title": "Summer Promotion",
            "label": "Save 20%",
            "code": "SUMMER25",
            "description": "20% off selected departures this month.",
            "netDiscount": "FULL",
            "restrictions": {
              "minUnits": 1,
              "maxUnits": 10,
              "minTotal": 0,
              "maxTotal": 50000,
              "unitIds": [
                "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
                "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
              ]
            },
            "usable": true,
            "unusableReason": "Offer is not valid for the selected date.",
            "membershipBenefit": {
              "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
              "title": "Summer Promotion",
              "description": "Morning departure with central pickup included."
            }
          }
        ],
        "packageAvailabilities": [
          {
            "allDay": false,
            "available": true,
            "capacity": 2,
            "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
            "localDateTimeEnd": "2026-03-01T12:00:00-08:00",
            "localDateTimeStart": "2026-03-01T09:00:00-08:00",
            "maxPaxCount": 2,
            "maxUnits": 2,
            "openingHours": [
              {
                "from": "09:00",
                "to": "17:00"
              }
            ],
            "packageIncludeId": "package_include_id-example",
            "paxCount": 2,
            "reference": "REF-2026-001",
            "status": "AVAILABLE",
            "statusMessage": "Limited availability for this departure.",
            "utcCutoffAt": "2026-05-14T13:00:00Z",
            "utcOnsaleAt": "2026-05-14T13:00:00Z",
            "vacancies": 2,
            "extraPricing": [
              {
                "currency": "USD",
                "currencyPrecision": 2,
                "extraId": "extra_fast_track",
                "net": 18000,
                "original": 22000,
                "retail": 20000,
                "includedTaxes": [
                  {
                    "name": "Sales Tax",
                    "shortDescription": "Local sales tax",
                    "original": 2000,
                    "retail": 1800,
                    "net": 1600
                  }
                ],
                "offerDiscount": {
                  "retail": 2000,
                  "net": 2000,
                  "includedTaxes": [
                    {
                      "name": "Sales Tax",
                      "shortDescription": "Local sales tax",
                      "retail": 200,
                      "net": 200
                    }
                  ]
                }
              }
            ],
            "pricing": {
              "currency": "USD",
              "currencyPrecision": 2,
              "net": 18000,
              "original": 22000,
              "retail": 20000,
              "includedTaxes": [
                {
                  "name": "Sales Tax",
                  "shortDescription": "Local sales tax",
                  "original": 2000,
                  "retail": 1800,
                  "net": 1600
                }
              ],
              "offerDiscount": {
                "retail": 2000,
                "net": 2000,
                "includedTaxes": [
                  {
                    "name": "Sales Tax",
                    "shortDescription": "Local sales tax",
                    "retail": 200,
                    "net": 200
                  }
                ]
              }
            },
            "unitPricing": [
              {
                "currency": "USD",
                "currencyPrecision": 2,
                "net": 18000,
                "original": 22000,
                "retail": 20000,
                "unitId": "unit_adult",
                "unitType": "ADULT",
                "includedTaxes": [
                  {
                    "name": "Sales Tax",
                    "shortDescription": "Local sales tax",
                    "original": 2000,
                    "retail": 1800,
                    "net": 1600
                  }
                ],
                "offerDiscount": {
                  "retail": 2000,
                  "net": 2000,
                  "includedTaxes": [
                    {
                      "name": "Sales Tax",
                      "shortDescription": "Local sales tax",
                      "retail": 200,
                      "net": 200
                    }
                  ]
                }
              }
            ],
            "offer": {
              "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
              "tags": [
                "vip",
                "partner"
              ],
              "title": "Summer Promotion",
              "label": "Save 20%",
              "code": "SUMMER25",
              "description": "20% off selected departures this month.",
              "netDiscount": "FULL",
              "restrictions": {
                "minUnits": 1,
                "maxUnits": 10,
                "minTotal": 0,
                "maxTotal": 50000,
                "unitIds": [
                  "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
                  "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
                ]
              },
              "usable": true,
              "unusableReason": "Offer is not valid for the selected date.",
              "membershipBenefit": {
                "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
                "title": "Summer Promotion",
                "description": "Morning departure with central pickup included."
              }
            },
            "offerCode": "SUMMER25",
            "offers": [
              {
                "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
                "tags": [
                  "vip",
                  "partner"
                ],
                "title": "Summer Promotion",
                "label": "Save 20%",
                "code": "SUMMER25",
                "description": "20% off selected departures this month.",
                "netDiscount": "FULL",
                "restrictions": {
                  "minUnits": 1,
                  "maxUnits": 10,
                  "minTotal": 0,
                  "maxTotal": 50000,
                  "unitIds": [
                    "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
                    "6b65fd83-4a1f-4744-8f4a-c24d8d770f29"
                  ]
                },
                "usable": true,
                "unusableReason": "Offer is not valid for the selected date.",
                "membershipBenefit": {
                  "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
                  "title": "Summer Promotion",
                  "description": "Morning departure with central pickup included."
                }
              }
            ],
            "packageAvailabilities": "[Circular Reference]",
            "dropoffAvailable": true,
            "dropoffDispatch": {
              "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
              "name": "Morning City Tour",
              "phoneNumber": "[phone]",
              "vehicle": "coach_12"
            },
            "dropoffPoints": [
              {
                "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
                "title": "Summer Promotion",
                "description": "Morning departure with central pickup included.",
                "localDateTime": "2026-05-14",
                "localDateTimeTo": "2026-05-14",
                "latitude": 10,
                "longitude": 10,
                "address": "123 Main St, San Francisco, CA",
                "googlePlaceId": "google_place_id-example"
              }
            ],
            "dropoffRequired": true,
            "pickupAvailable": true,
            "pickupDispatch": {
              "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
              "name": "Morning City Tour",
              "phoneNumber": "[phone]",
              "vehicle": "coach_12"
            },
            "pickupPoints": [
              {
                "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
                "title": "Summer Promotion",
                "description": "Morning departure with central pickup included.",
                "localDateTime": "2026-05-14",
                "localDateTimeTo": "2026-05-14",
                "latitude": 10,
                "longitude": 10,
                "address": "123 Main St, San Francisco, CA",
                "googlePlaceId": "google_place_id-example"
              }
            ],
            "pickupRequired": true,
            "hasResources": true,
            "mappings": [
              {
                "resellerReference": "RES-BOOK-10045",
                "resellerStatus": "CONFIRMED",
                "resellerProduct": "grand-canyon-day-tour",
                "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
                "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
                "unitId": "unit_adult",
                "optionRequired": true,
                "unitRequired": true,
                "validityDays": 2,
                "webhookUrl": "https://www.city-sightseeing.com"
              }
            ]
          }
        ],
        "dropoffAvailable": true,
        "dropoffDispatch": {
          "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "name": "Morning City Tour",
          "phoneNumber": "[phone]",
          "vehicle": "coach_12"
        },
        "dropoffPoints": [
          {
            "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
            "title": "Summer Promotion",
            "description": "Morning departure with central pickup included.",
            "localDateTime": "2026-05-14",
            "localDateTimeTo": "2026-05-14",
            "latitude": 10,
            "longitude": 10,
            "address": "123 Main St, San Francisco, CA",
            "googlePlaceId": "google_place_id-example"
          }
        ],
        "dropoffRequired": true,
        "pickupAvailable": true,
        "pickupDispatch": {
          "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "name": "Morning City Tour",
          "phoneNumber": "[phone]",
          "vehicle": "coach_12"
        },
        "pickupPoints": [
          {
            "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
            "title": "Summer Promotion",
            "description": "Morning departure with central pickup included.",
            "localDateTime": "2026-05-14",
            "localDateTimeTo": "2026-05-14",
            "latitude": 10,
            "longitude": 10,
            "address": "123 Main St, San Francisco, CA",
            "googlePlaceId": "google_place_id-example"
          }
        ],
        "pickupRequired": true,
        "hasResources": true,
        "mappings": [
          {
            "resellerReference": "RES-BOOK-10045",
            "resellerStatus": "CONFIRMED",
            "resellerProduct": "grand-canyon-day-tour",
            "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
            "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
            "unitId": "unit_adult",
            "optionRequired": true,
            "unitRequired": true,
            "validityDays": 2,
            "webhookUrl": "https://www.city-sightseeing.com"
          }
        ]
      }
    ],
    "dropoffAvailable": true,
    "dropoffDispatch": {
      "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
      "name": "Morning City Tour",
      "phoneNumber": "[phone]",
      "vehicle": "coach_12"
    },
    "dropoffPoints": [
      {
        "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
        "title": "Summer Promotion",
        "description": "Morning departure with central pickup included.",
        "localDateTime": "2026-05-14",
        "localDateTimeTo": "2026-05-14",
        "latitude": 10,
        "longitude": 10,
        "address": "123 Main St, San Francisco, CA",
        "googlePlaceId": "google_place_id-example"
      }
    ],
    "dropoffRequired": true,
    "pickupAvailable": true,
    "pickupDispatch": {
      "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
      "name": "Morning City Tour",
      "phoneNumber": "[phone]",
      "vehicle": "coach_12"
    },
    "pickupPoints": [
      {
        "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
        "title": "Summer Promotion",
        "description": "Morning departure with central pickup included.",
        "localDateTime": "2026-05-14",
        "localDateTimeTo": "2026-05-14",
        "latitude": 10,
        "longitude": 10,
        "address": "123 Main St, San Francisco, CA",
        "googlePlaceId": "google_place_id-example"
      }
    ],
    "pickupRequired": true,
    "hasResources": true,
    "mappings": [
      {
        "resellerReference": "RES-BOOK-10045",
        "resellerStatus": "CONFIRMED",
        "resellerProduct": "grand-canyon-day-tour",
        "productId": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
        "optionId": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
        "unitId": "unit_adult",
        "optionRequired": true,
        "unitRequired": true,
        "validityDays": 2,
        "webhookUrl": "https://www.city-sightseeing.com"
      }
    ]
  }
]