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-tiqt-test.steq.it/v2https://api.tiqets.com/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

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-tiqt-test.steq.it
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
}