---
title: "Search and filter experiences"
method: GET
path: "/experiences"
tags: ["Content API"]
---

# Search and filter experiences

`GET /experiences`

## Query parameters

- `city_id` integer
- `country_id` integer
- `type` 'venue' | 'activity' | 'service' | 'poi'
- `currency` string
- `lang` string
- `page_size` integer
- `page` integer

## Headers

- `Authorization` string, required

## Response `200`

Successful operation.

- object
  - `success` boolean
  - `pagination` Pagination
    - `total` integer — Total number of items.
    - `page` integer — Number of the current page.
    - `page_size` integer — Size of the current page.
  - `experiences` Experience[]
    - `id` integer — Unique Tiqets ID of the experience.
    - `type` 'activity' | 'service' | 'venue' | 'poi' — Type of the experience. Tiqets currently categorises each experience into one of these four types: activity (e.g. a guided tour), service (e.g. public transport), venue (e.g. a museum), or poi (point of interest).
    - `language` string — Language of the content information as in the request parameter. The format follows ISO 639-1 codes.
    - `title` string — Localized title.
    - `images` Image[] — Array of image URLs in different sizes and corresponding image information.
      - `small` string — URL of small size image.
      - `medium` string — URL of medium size image.
      - `large` string — URL of large size image.
      - `extra_large` string — URL of extra large size image.
      - `alt_text` string, nullable — ALT text for the image. Returned if available for the image in the defined request language. Returned as `null` if no ALT text is available.
      - `credit` string, nullable — Image credit information. Credit needs to be shown when an image is shown on your system. Tiqets cannot be held liable for any infringement.
    - `address` object — Address of the experience.
      - `street` string, nullable — Street and number of the experience.
      - `postal_code` string, nullable — Postal code of the experience.
      - `city_id` integer — Tiqets ID of the experience city.
      - `city_name` string — Localized name of the experience city.
      - `country_id` integer — Tiqets ID of the experience country.
      - `country_name` string — Localized name of the experience country.
      - `lat` number, nullable — The latitude of the experience.
      - `lng` number, nullable — The longitude of the experience.
      - `google_place_id` string, nullable — Google Place ID of the experience.
    - `tag_ids` integer[] — List of tag IDs. See tags.
    - `product_ids` integer[] — List of product IDs that belong to the experience.
    - `experience_url` string — URL to the experience on the Tiqets.com website. The field `experience_url` points to the consumer Tiqets.com website. An affiliate tracking code is added to the URL to measure usage and track what orders are done by what partner (`?partner=foobar`). The URL does not contain or follow any currency parameter. The currency shown is determined by the configuration of the browser accessing the URL.
    - `ratings` object — Ratings object.
      - `average` number — Average number of ratings/reviews (1-5 star rating).
      - `total` integer — Total number of ratings/reviews.
    - `currency` string, nullable — Currency code (ISO 4217) of the price. Defaults to EUR if no currency is provided as request parameter.
    - `from_price` number, nullable — From price of the experience.
    - `tagline` string — Localized tagline.
    - `description` string, nullable — Experience description.

## 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.net/tiqets/apis/tiqets-distributor-api.md) · [All operations](https://skmtc.net/tiqets/apis/tiqets-distributor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiqets/tiqets-distributor-api/versions/eaf9cf96606a/schema)