Localization

Content available for multiple languages

Suppliers can store content in multiple languages in Ventrata. Requests should include the Accept-Language header, ideally matching the language preferences sent by the client browser or user agent.

More information about the structure of that header is available on MDN.

The API attempts to match the preferred languages against languages already translated by the supplier. The response includes a Content-Language header indicating the language returned, consistent with the HTTP standard.

Use the product operation below with the Accept-Language header to request localized content:

Get Product

get

Get details on a specific product.

Path parameters

productIdstringRequired

Product ID, for example: 94cdd032-3d32-416d-b0a4-abf8b7495b8b.

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

Query parameters

currencystringOptional

Optional currency override. Use an ISO-4217 currency code from availableCurrencies or default.

Example: USD

offerCodestringOptional

Offer code or combination context.

Example: SUMMER25

membership[id]string · uuidOptional

Membership identifier returned by /memberships/lookup. When set, also include membership[verification] and one of membership[email], membership[mobile], or membership[reference].

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

membership[email]string · emailOptional

Membership email used during lookup.

Example: [email protected]

membership[mobile]stringOptional

Membership mobile number used during lookup.

Example: [phone]

membership[country]stringOptional

ISO 3166-1 alpha-2 country code used to parse membership[mobile].

Example: US

membership[reference]stringOptional

Membership reference used during lookup. Use with membership[id] and membership[verification] as one of the allowed lookup identifiers.

Example: REF-2026-001

membership[verification]stringOptional

Verification token from lookup (OTP for email/mobile, or guest name for reference). Required when membership[id] is provided.

Example: 123456

Header parameters

Accept-LanguagestringRequired

fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5

Example: en-US

Octo-CapabilitiesstringOptional

Optional comma-separated capability IDs.

Example: octo/pricing,octo/offers

Responses

200

Successful response

application/json

get

/products/{productId}

HTTPcURLJavaScriptPython

GET /octo/products/{productId} HTTP/1.1
Host: api.ventrata.com
Accept-Language: text
Accept: */*

200

Successful response

{
  "allowFreesale": true,
  "availabilityRequired": true,
  "availabilityType": "START_TIME",
  "deliveryFormats": [
    "PDF_URL",
    "QRCODE"
  ],
  "deliveryMethods": [
    "VOUCHER",
    "TICKET"
  ],
  "fixedWeight": true,
  "freesaleDurationAmount": 220,
  "freesaleDurationRoundup": true,
  "freesaleDurationRoundupUnit": "HOUR",
  "freesaleDurationUnit": "HOUR",
  "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
  "instantConfirmation": true,
  "instantDelivery": true,
  "internalName": "Walking Tour of Barcelona",
  "locale": "en",
  "operator": {
    "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
    "name": "Morning City Tour"
  },
  "options": [
    {
      "availabilityCutoff": "2026-05-14T09:00:00-04:00",
      "availabilityCutoffAmount": 2,
      "availabilityCutoffUnit": "2026-05-14T09:00:00-04:00",
      "availabilityLocalDateEnd": "2026-12-31",
      "availabilityLocalDateStart": "2026-01-01",
      "availabilityLocalStartTimes": [
        "09:00",
        "13:00"
      ],
      "availabilityNotice": "2026-05-14T09:00:00-04:00",
      "availabilityNoticeAmount": 2,
      "availabilityNoticeUnit": "2026-05-14T09:00:00-04:00",
      "cancellationCutoff": "24",
      "cancellationCutoffAmount": 2,
      "cancellationCutoffUnit": "HOUR",
      "default": true,
      "id": "f1a5d2e8-8d57-4f0b-9c3f-6a12d7a8bc90",
      "internalName": "DEFAULT",
      "reference": "REF-2026-001",
      "requiredContactFields": [
        "fullName",
        "emailAddress"
      ],
      "restrictions": {
        "minUnits": 2,
        "maxUnits": 2,
        "minPaxCount": 2,
        "maxPaxCount": 2,
        "minTotal": 2,
        "maxTotal": 2,
        "unitIds": [
          "unit_adult",
          "unit_child"
        ]
      },
      "tags": [
        "vip",
        "partner"
      ],
      "units": [
        {
          "id": "94cdd032-3d32-416d-b0a4-abf8b7495b8b",
          "internalName": "Adult",
          "reference": "adult",
          "requiredContactFields": [
            "fullName",
            "emailAddress"
          ],
          "restrictions": {
            "required": true,
            "default": true,
            "minAge": 34,
            "maxAge": 34,
            "idRequired": true,
            "minQuantity": 2,
            "maxQuantity": 2,
            "paxCount": 2,
            "accompaniedBy": [
              "accompanied_by-example"
            ],
            "accompaniedByRatio": 2,
            "accompaniedByRatioDenominator": 2
          },
          "tags": [
            "vip",
            "partner"
          ],
          "type": "ADULT",
          "visibleContactFields": [
            "fullName",
            "emailAddress"
          ],
          "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
                }
              ]
            }
          },
          "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
                }
              ]
            }
          },
          "extras": [
            {
              "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
              "internalName": "Morning City Tour",
              "reference": "REF-2026-001",
              "title": "Summer Promotion",
              "shortDescription": "Central departure with multilingual guide.",
              "coverImageUrl": "https://www.city-sightseeing.com",
              "duration": "2",
              "durationAmount": 220,
              "durationUnit": "HOUR",
              "tags": [
                "vip",
                "partner"
              ],
              "restrictions": {
                "required": true,
                "default": true,
                "minAge": 34,
                "maxAge": 34,
                "idRequired": true,
                "minQuantity": 2,
                "maxQuantity": 2,
                "paxCount": 2,
                "accompaniedBy": [
                  "accompanied_by-example"
                ],
                "accompaniedByRatio": 2,
                "accompaniedByRatioDenominator": 2
              },
              "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
                    }
                  ]
                }
              },
              "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
                    }
                  ]
                }
              }
            }
          ],
          "questions": [
            {
              "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
              "title": "Summer Promotion",
              "required": true,
              "inputType": "select",
              "maxLength": 2,
              "selectOptions": [
                {
                  "value": "value-example",
                  "label": "label-example"
                }
              ]
            }
          ],
          "isMembership": true,
          "membershipBenefit": {
            "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
            "title": "Summer Promotion",
            "description": "Morning departure with central pickup included."
          }
        }
      ],
      "visibleContactFields": [
        "fullName",
        "emailAddress"
      ],
      "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
            }
          ]
        }
      },
      "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
            }
          ]
        }
      },
      "itinerary": [
        {
          "name": "Morning City Tour",
          "type": "STANDARD",
          "description": "Morning departure with central pickup included.",
          "address": "123 Main St, San Francisco, CA",
          "googlePlaceId": "google_place_id-example",
          "latitude": 10,
          "longitude": 10,
          "travelTime": "15",
          "travelTimeAmount": 220,
          "travelTimeUnit": "MINUTE",
          "duration": "2",
          "durationAmount": 220,
          "durationUnit": "HOUR"
        }
      ],
      "extras": [
        {
          "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "internalName": "Morning City Tour",
          "reference": "REF-2026-001",
          "title": "Summer Promotion",
          "shortDescription": "Central departure with multilingual guide.",
          "coverImageUrl": "https://www.city-sightseeing.com",
          "duration": "2",
          "durationAmount": 220,
          "durationUnit": "HOUR",
          "tags": [
            "vip",
            "partner"
          ],
          "restrictions": {
            "required": true,
            "default": true,
            "minAge": 34,
            "maxAge": 34,
            "idRequired": true,
            "minQuantity": 2,
            "maxQuantity": 2,
            "paxCount": 2,
            "accompaniedBy": [
              "accompanied_by-example"
            ],
            "accompaniedByRatio": 2,
            "accompaniedByRatioDenominator": 2
          },
          "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
                }
              ]
            }
          },
          "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
                }
              ]
            }
          }
        }
      ],
      "packageIncludes": [
        {
          "id": "89fe0192-ddcd-430a-b285-e1396a4725d2",
          "title": "Summer Promotion",
          "description": "Morning departure with central pickup included.",
          "includes": [
            "[Circular Reference]"
          ]
        }
      ],
      "dropoffAvailable": true,
      "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,
      "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,
      "questions": [
        {
          "id": "3d6f0a3a-59d4-4b16-a0c5-11d2d8a4e6b7",
          "title": "Summer Promotion",
          "required": true,
          "inputType": "select",
          "maxLength": 2,
          "selectOptions": [
            {
              "value": "value-example",
              "label": "label-example"
            }
          ]
        }
      ],
      "rentalDurations": [
        {
          "id": "e7cc8bb4-8d1c-4848-8824-5dbedb718681",
          "duration": "2",
          "durationAmount": 220,
          "durationUnit": "HOUR",
          "title": "Summer Promotion",
          "description": "Morning departure with central pickup included."
        }
      ]
    }
  ],
  "redemptionMethod": "DIGITAL",
  "reference": "BRC-WALK",
  "settlementMethods": [
    "DIRECT",
    "DEFERRED"
  ],
  "tags": [
    "vip",
    "partner"
  ],
  "timeZone": "Europe/Madrid",
  "weightUnit": "kg",
  "availableCurrencies": [
    "USD",
    "EUR"
  ],
  "defaultCurrency": "USD",
  "hidePricingFrom": true,
  "includeTax": true,
  "includedTaxes": [
    {
      "name": "Sales Tax",
      "shortDescription": "Local sales tax",
      "original": 2000,
      "retail": 1800,
      "net": 1600
    }
  ],
  "pricingMultiplier": 10,
  "pricingPer": "UNIT",
  "isPackage": true,
  "isPackagePass": true,
  "packageProduct": true,
  "isRental": true,
  "isMembership": true,
  "membershipAutoRenew": true
}

The response Content-Language reflects the resolved language (for example English when no other translation exists):

If you cache content locally, use the Octo-Available-Languages header, which lists languages translated by the supplier.

You can repeat the request with each available language to retrieve localized content.