Get all active product variants

This endpoint returns details about all active variants of a product. There is no actual availability returned; the endpoint is supposed to be used for the mapping of products on your system.

Availability and pricing for a certain time frame can be retrieved via the dedicated endpoint.

All active product variants

get

https://api.tiqets.com/v2https://api-tiqt-test.steq.it/v2https://api.api-tiqt-test.steq.it/v2

/products/{productId}/product-variants

Path parameters

productIdintegerRequired

ID of the product to return.

Example: 974092

Query parameters

langstringOptional

Language of the variants to retrieve.

Example: en

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Responses

200

Successful operation.

application/json

successbooleanOptional

sales_enabledbooleanOptional

Indicates whether the product is available for sale or not.

dynamic_pricingbooleanOptionalDeprecated

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_orderinteger · nullableOptional

Maximum total number of tickets of any product variant that can be purchased in one order.

400

Bad Request -- Check your request parameters (typo in parameter or invalid value).

application/json

401

Unauthorized -- Your API key is incorrect.

application/json

403

Forbidden -- The endpoint or parameters are not allowed for the matching API key.

application/json

404

Not Found -- Requested resource/endpoint could not be found.

application/json

405

Method Not Allowed -- Check your request method.

application/json

429

Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.

application/json

500

Internal Server Error -- We had a problem with our server. Try again later.

application/json

503

Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

application/json

get

/products/{productId}/product-variants

HTTPcURLJavaScriptPython

GET /v2/products/{productId}/product-variants HTTP/1.1
Host: api.tiqets.com
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "success": true,
  "variants": [
    {
      "description": "Age: 18 - 21.",
      "age_range": {
        "age_from": 18,
        "age_to": 21
      },
      "requires_visitors_details": [],
      "min_per_order": null,
      "label": "Adult (17+)",
      "is_addon": false,
      "variant_type": "adult",
      "maximum_visitors_per_ticket": 1,
      "group_ids": [
        5
      ],
      "languages": [],
      "language_selection": [],
      "cancellation": {
        "window": null,
        "policy": "never"
      },
      "id": 21035,
      "valid_with_variant_ids": []
    },
    {
      "description": null,
      "age_range": {
        "age_from": null,
        "age_to": null
      },
      "requires_visitors_details": [],
      "min_per_order": null,
      "label": "Child (4-16)",
      "is_addon": false,
      "variant_type": "child",
      "maximum_visitors_per_ticket": 1,
      "group_ids": [
        5
      ],
      "languages": [],
      "language_selection": [],
      "cancellation": {
        "window": null,
        "policy": "never"
      },
      "id": 21036,
      "valid_with_variant_ids": []
    },
    {
      "description": "Age: 0 - 40. Description",
      "age_range": {
        "age_from": null,
        "age_to": 40
      },
      "requires_visitors_details": [],
      "min_per_order": null,
      "label": "Infant (0-3)",
      "is_addon": false,
      "variant_type": "infant",
      "maximum_visitors_per_ticket": 1,
      "group_ids": [
        5,
        1337
      ],
      "languages": [],
      "language_selection": [],
      "cancellation": {
        "window": null,
        "policy": "never"
      },
      "id": 21037,
      "valid_with_variant_ids": [
        21035,
        21036,
        21038,
        22101,
        22102,
        22103
      ]
    },
    {
      "description": "Age: 18+. With a valid student card.",
      "age_range": {
        "age_from": 18,
        "age_to": null
      },
      "requires_visitors_details": [],
      "min_per_order": null,
      "label": "University Student",
      "is_addon": false,
      "variant_type": "reduced",
      "maximum_visitors_per_ticket": 1,
      "group_ids": [
        5
      ],
      "languages": [],
      "language_selection": [],
      "cancellation": {
        "window": null,
        "policy": "never"
      },
      "id": 21038,
      "valid_with_variant_ids": []
    },
    {
      "description": "Description",
      "age_range": {
        "age_from": null,
        "age_to": null
      },
      "requires_visitors_details": [],
      "min_per_order": null,
      "label": "Audio Guide",
      "is_addon": true,
      "variant_type": "regular",
      "maximum_visitors_per_ticket": 1,
      "group_ids": [
        5
      ],
      "languages": [],
      "language_selection": [],
      "cancellation": {
        "window": null,
        "policy": "never"
      },
      "id": 21847,
      "valid_with_variant_ids": []
    },
    {
      "description": "Description",
      "age_range": {
        "age_from": null,
        "age_to": null
      },
      "requires_visitors_details": [],
      "min_per_order": null,
      "label": "Adult (17+)",
      "is_addon": false,
      "variant_type": "adult",
      "maximum_visitors_per_ticket": 1,
      "group_ids": [
        1337
      ],
      "languages": [],
      "language_selection": [],
      "cancellation": {
        "window": null,
        "policy": "never"
      },
      "id": 22101,
      "valid_with_variant_ids": []
    },
    {
      "description": "Age: 3 - 18.",
      "age_range": {
        "age_from": 3,
        "age_to": 18
      },
      "requires_visitors_details": [],
      "min_per_order": null,
      "label": "Child (4-16)",
      "is_addon": false,
      "variant_type": "child",
      "maximum_visitors_per_ticket": 1,
      "group_ids": [
        1337
      ],
      "languages": [],
      "language_selection": [],
      "cancellation": {
        "window": null,
        "policy": "never"
      },
      "id": 22102,
      "valid_with_variant_ids": []
    },
    {
      "description": "Age: 20+. With a valid student card.",
      "age_range": {
        "age_from": 20,
        "age_to": null
      },
      "requires_visitors_details": [],
      "min_per_order": null,
      "label": "University Student",
      "is_addon": false,
      "variant_type": "reduced",
      "maximum_visitors_per_ticket": 1,
      "group_ids": [
        1337
      ],
      "languages": [],
      "language_selection": [],
      "cancellation": {
        "window": null,
        "policy": "never"
      },
      "id": 22103,
      "valid_with_variant_ids": []
    }
  ],
  "groups": [
    {
      "id": 5,
      "name": "Entry Ticket"
    },
    {
      "id": 1337,
      "name": "Entry Ticket and Guided Tour"
    }
  ],
  "sales_enabled": true,
  "dynamic_pricing": true,
  "max_tickets_per_order": 20
}