---
title: "All active product variants"
method: GET
path: "/products/{productId}/product-variants"
tags: ["Availability & Pricing API"]
---

# All active product variants

`GET /products/{productId}/product-variants`

## Request

- Base URL: `https://api.tiqets.com/v2`
- URL: `https://api.tiqets.com/v2/products/{productId}/product-variants`
- Auth: none declared. Required headers: `Authorization`

## Path parameters

- `productId` integer, required

## Query parameters

- `lang` string: Language of the variants to retrieve.

## Headers

- `Authorization` string, required

## Response `200`

Successful operation.

- object
  - `success` boolean
  - `variants` object[]: Active product variants
    - `description` string: Localized description for the variant.
    - `age_range` object: Age range for the variant.
      - `age_from` integer, nullable: Minimum age requirement for the variant.
      - `age_to` integer, nullable: Maximum age requirement for the variant.
    - `requires_visitors_details` string[], nullable: For products that require visitor's details, this is a list of additional data fields required when placing an order. - full_name: The full name of each visitor as in the first name and last name in Latin characters without special characters or numbers - email: email of each visitor. - phone: phone of each visitor. - nationality: The nationality of each visitor. - passport_id: Passport ID of the (main) visitor. (on order level, not per individual visitor) - passport_ids: Passport ID of each visitor. - date_of_birth: The date of birth of each visitor. Date format YYYY-MM-DD. - weight_kg: The weight of each visitor in kg. This field might be required for weight-sensitive experiences such as helicopter flights. - weight_lb: The weight of each visitor in lb. This field might be required for weight-sensitive experiences such as helicopter flights. - address: The home address of each visitor. Expects a non-empty string. - zipcode: The US Zipcode/Postal code if the visitor lives in the United States. Expects a 5-digit number. (on order level, not per individual visitor) - pickup_location: The holiday address of visitors. The tour provider may contact the visitor to arrange the nearest pickup location. (on order level, not per individual visitor) - dropoff_location: The address where the visitors want to be dropped off after the ordered product/activity. (on order level, not per individual visitor) - flight_number: The number of the flight the visitors arrive with. This allows the supplier to be at the right time and location if a product includes an airport pickup/dropoff. (on order level, not per individual visitor) - dietary_preference: The preference or restrictions for the diet of the visitor. - us_mandatory_zipcode: similar to zipcode, but mandatory.
    - `min_per_order` integer, nullable: The minimum number of tickets required to create an order.
    - `max_per_order` integer, nullable: The maximum number of tickets allowed to create an order.
    - `label` string: Localized label for the variant.
    - `is_addon` boolean, nullable: True if the variant is an addon that can only be sold in combination with a non-addon variant. False if the variant can be sold as stand-alone.
    - `variant_type` 'adult' | 'youth' | 'child' | 'infant' | 'senior' | 'family' | 'regular' | 'reduced': Variant type classification to enable machine matching/processing of certain properties of a variant.
    - `maximum_visitors_per_ticket` integer: Number of visitors that can use one ticket of this type. If the variant is not of type family, the value is always 1. Family variants can typically be used by more than one visitor, a detailed description can be found in the label and description of the variant.
    - `group_ids` integer[], nullable: List of group ID, associated with the variant. NOTE: Multiple IDs can be associated with one variant.
    - `languages` string[]: List of the languages of available tour guides for this variant. The format generally follows ISO 639-1 codes; for languages that do not have a 639-1 code, it is in 639-3.
    - `language_selection` string[], nullable: List of the languages of available tour guides for this variant. The format follows ISO 639-3 codes. If this is not `null`, customers need to select a language on the tiqets.com checkout. Please refer to [How to implement language selection](https://developers.tiqets.dev/integration-guides/product-integration/how-to-implement-language-selection) for more details.
    - `cancellation` object: Cancellation information.
      - `window` integer, nullable: The cancellation window in hours corresponds to the cancellation policy.
      - `policy` 'before_timeslot' | 'before_date' | 'never': Indicates the cancellation policy of the product. Possible values: - before_date: Indicates that cancellation must be done (window) hours before 12 AM on the date of the visit. - before_timeslot: Indicates that cancellation must be done (window) hours before the timeslot or venue's opening hour. - never: Indicates that a cancellation is never possible.
    - `id` integer: Variant identifier.
    - `valid_with_variant_ids` integer[]: List of variant_ids, only with these variants will this variant be valid for orders.
  - `groups` object[]: Group ID and label description.
    - `id` integer: Unique variant group identifier.
    - `name` string: Group label.
  - `sales_enabled` boolean: Indicates whether the product is available for sale or not.
  - `dynamic_pricing` boolean: If true, the price depends on the day and timeslot, as well as the day on which the data is requested. Products with dynamic pricing can have different prices for one date for one variant ID, and it allows for active price changes from the supplier.
  - `max_tickets_per_order` integer, nullable: Maximum total number of tickets of any product variant that can be purchased in one order.
  - `min_tickets_per_order` number, nullable: Minimum total number of tickets of any product variant that can be purchased in one order.

## Other responses

- `400`: Bad Request -- Check your request parameters (typo in parameter or invalid value).
- `401`: Unauthorized -- Your API key is incorrect.
- `403`: Forbidden -- The endpoint or parameters are not allowed for the matching API key.
- `404`: Not Found -- Requested resource/endpoint could not be found.
- `405`: Method Not Allowed -- Check your request method.
- `429`: Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.
- `500`: Internal Server Error -- We had a problem with our server. Try again later.
- `503`: Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

---

[API](https://skmtc.dev/tiqets/apis/tiqets-distributor-api.md) - [All operations](https://skmtc.dev/tiqets/apis/tiqets-distributor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiqets/apis/tiqets-distributor-api/revisions/eaf9cf96606a?raw)
