Skip to main content
GET
/
api
/
public
/
v1
/
category
/
list-by
/
city
cURL
curl --location 'https://www.headout.com/api/public/v1/category/list-by/city?cityCode=DUBAI' \
--header 'Headout-Auth: <YOUR_API_KEY>'

{
  "items": [
    {
      "id": "<string>",
      "name": "<string>",
      "cityCode": "<string>",
      "canonicalUrl": "<string>",
      "localeSpecificUrls": {}
    }
  ],
  "nextUrl": "<string>",
  "prevUrl": "<string>",
  "total": 123,
  "nextOffset": 123
}

Authorizations

​
Headout-Auth
string
header
required

Query Parameters

​
cityCode
string
required

City code to list categories for.

​
offset
string

Number of items to skip before starting to collect the result set.

​
limit
integer

Maximum number of items to return.

Response

200 - application/json

Successful response

​
items
object[]

The categories in this page of results.

​
nextUrl
string

Full URL to fetch the next page of results. Null if on the last page.

​
prevUrl
string

Full URL to fetch the previous page of results. Null if on the first page.

​
total
integer

Total number of categories matching the query across all pages.

​
nextOffset
integer

Offset value to use in the next request to retrieve the following page.