Search and filter temporary events

TBC

Search and filter temporary events

get

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

/temporary-events

Query parameters

langstringOptional

Language of the content to retrieve (ISO 639-1). Defaults to English if undefined.

Default: enExample: en

page_sizeinteger · min: 1 · max: 100Optional

Number of items per page. Default value is 10, maximum value is 100.

Default: 10Example: 5

pageinteger · min: 1Optional

Number of the page to retrieve. Used in combination with the page_size parameter to define the page size.

Default: 1Example: 1

city_idintegerOptional

Filter results by city. Use the /cities endpoint to find the IDs Tiqets has assigned to the various known cities. Repeat the city_id parameter to broaden the search to span multiple cities.

Example: 113

country_idintegerOptional

Filter results by country. Use the /countries endpoint to find the IDs Tiqets has assigned to the various known countries. Repeat the country_id parameter to broaden the search to span multiple countries.

Example: 50233

experience_idintegerOptional

Filter results by experience. Use the /experiences endpoint to find the IDs Tiqets has assigned to the various known experiences. Repeat the experience_id parameter to broaden the search to span multiple experiences.

Example: 145528

from_datestring · dateOptional

Filter by when temporary events are active. Defaults to today when omitted. If to_date is provided, only events that are active at any time between this date and to_date are returned. If to_date is omitted, only events that are active on or after this date are returned.

Example: 2026-06-05Pattern: YYYY-MM-DD

to_datestring · dateOptional

End of the date range for filtering temporary events. When provided together with from_date, only events that are active at any time between from_date and this date are returned. When omitted, no upper bound is applied (events from from_date onwards).

Example: 2026-06-30Pattern: YYYY-MM-DD

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Responses

200

Successful operation.

application/json

successbooleanOptional

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

/temporary-events

HTTPcURLJavaScriptPython

GET /v2/temporary-events HTTP/1.1
Host: api.tiqets.com
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "success": true,
  "pagination": {
    "total": 5,
    "page": 1,
    "page_size": 100
  },
  "events": [
    {
      "id": 42,
      "title": "Leaonardo Da Vinci. 500 years of Genius",
      "description": "The exhibition is a celebration of the 500th anniversary of Leonardo da Vinci's death. It features over 100 of his most famous works, including The Mona Lisa, The Last Supper, and The Vitruvian Man.\n",
      "event_type": "exhibition",
      "experience_id": 145528,
      "experience_name": "Prince Felipe Science Museum",
      "from_date": "2026-06-05",
      "to_date": "2026-06-30",
      "tiqets_url": "https://www.tiqets.com/en/entradas-museo-de-las-ciencias-de-valencia-l154852/leaonardo-da-vinci-500-years-of-genius-e72447/",
      "image": {
        "small": "https://aws-tiqets-cdn.imgix.net/images/content/3a740f66b9664886b391b042f442edde.jpg?auto=format%2Ccompress&fit=crop&h=128&ixlib=python-4.0.0&q=70&w=128",
        "medium": "https://aws-tiqets-cdn.imgix.net/images/content/3a740f66b9664886b391b042f442edde.jpg?auto=format%2Ccompress&fit=crop&h=250&ixlib=python-4.0.0&q=70&w=250",
        "large": "https://aws-tiqets-cdn.imgix.net/images/content/3a740f66b9664886b391b042f442edde.jpg?auto=format%2Ccompress&fit=crop&h=500&ixlib=python-4.0.0&q=70&w=500",
        "extra_large": "https://aws-tiqets-cdn.imgix.net/images/content/3a740f66b9664886b391b042f442edde.jpg?auto=format%2Ccompress&fit=crop&h=1284&ixlib=python-4.0.0&q=70&w=1284",
        "alt_text": "People riding an open-top tour bus along a coastal promenade lined with palm trees, with buildings and the sea in the background.",
        "credit": "Photo by Tiqets"
      },
      "access_product_ids": [
        1006356,
        1006357
      ]
    }
  ]
}