Get list of tags

Products can have multiple tags that classify them into different categories in several aspects. Each of these aspects is modeled as a tag type.

For example, to determine whether or not this product is a History Museum, you can check if it has a tag with the id '702'.

These endpoints allow you to retrieve one or multiple tags along with their tag types.

Get list of tags

get

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

/tags

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

type_namestringOptional

Name of the type of tags to retrieve; i.e. 'category', 'time_of_day', etc.

Example: category

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

/tags

HTTPcURLJavaScriptPython

GET /v2/tags HTTP/1.1
Host: api-tiqt-test.steq.it
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "success": true,
  "pagination": {
    "total": 5,
    "page": 1,
    "page_size": 100
  },
  "tags": [
    {
      "id": "1188",
      "name": "Couples",
      "type_name": "Traveler type",
      "type_id": "273",
      "type_group_name": "Activity categories"
    },
    {
      "id": "1041",
      "name": "Hop-On Hop-Off",
      "type_name": "Tours",
      "type_id": "236",
      "type_group_name": "Product Sub-categories"
    },
    {
      "id": "726",
      "name": "National Parks",
      "type_name": "Nature",
      "type_id": "140",
      "type_group_name": "Activity categories"
    },
    {
      "id": "702",
      "name": "History Museums",
      "type_name": "Museums",
      "type_id": "137",
      "type_group_name": "Product Sub-categories"
    },
    {
      "id": "703",
      "name": "Science & Technology Museums",
      "type_name": "Museums",
      "type_id": "137",
      "type_group_name": "Activity categories"
    }
  ]
}