Skip to main content
GET
/
api
/
public
/
v2
/
categories
cURL
curl --location 'https://www.headout.com/api/public/v2/categories?cityCode=<CITY_CODE>&languageCode=<LANGUAGE_CODE>' \
--header 'Headout-Auth: <YOUR_API_KEY>'

{
  "categories": [
    {
      "id": "<string>",
      "name": "<string>",
      "localeSpecificUrls": {},
      "canonicalUrl": "<string>"
    }
  ]
}

Authorizations

​
Headout-Auth
string
header
required

Query Parameters

​
cityCode
string
required

Uppercase city identifier (e.g., NEW_YORK, DUBAI, LONDON). Use the Cities API to retrieve all available city codes.

​
languageCode
enum<string>
default:EN

Language code for localizing response content including product names, descriptions, and URLs. Defaults to English (EN). See supported language codes.

Available options:
EN,
ES,
FR,
IT,
DE,
PT,
NL,
PL

Response

200 - application/json

Successful response

​
categories
object[]

All top-level experience categories available in the requested city.