Home/ Discovery/ Categories

Categories & Sub-Categories

Fetch experience categories and their nested sub-categories. These are used to power filter chips and multi-level navigation on the browse page.

# Get Categories

Returns top-level experience categories. The code field is used to filter items on the browse page.

GET{{base_url}}/categories

Bearer Token Required

Query Parameters

Field	Type	Required	Description
latitude	number	OPTIONAL	User's current latitude for location-aware results. Example: `28.6358`
longitude	number	OPTIONAL	User's current longitude. Example: `77.22445`

Response — 200 OK

{
  "data": [
    {
      "name": "Culture & Heritage",
      "code": "CULTURE_HERITAGE",    // ← pass to GET /items as ?category=
      "image": "https://cdn.delite24.in/rzervit/categories/culture_heritage.png"
    },
    { "name": "Tours & Sightseeing", "code": "TOURS_SIGHTSEEING", "image": "..." },
    { "name": "Sporting & Outdoor",  "code": "SPORTING_OUTDOOR",  "image": "..." },
    { "name": "Leisure",             "code": "LEISURE",            "image": "..." }
  ]
}

Response Fields

Field	Description
name	Human-readable label for display in the UI
code	Category code — pass this as `?category=` in GET /items
image	CDN URL for the category icon/illustration

Usage: The code field (e.g., TOURS_SIGHTSEEING) is the key value. Pass it as the category query parameter in GET /items to filter items. Results are cached server-side for 6 hours.

# Get All Sub-Categories

Returns all categories with their nested sub-categories. Use for building multi-level category navigation or dropdown filters.

GET{{base_url}}/sub-categories

Bearer Token Required

Query Parameters

Field	Type	Required	Description
latitude	number	OPTIONAL	User's latitude. Example: `28.6358`
longitude	number	OPTIONAL	User's longitude. Example: `77.22445`

Response — 200 OK

{
  "data": {
    "mainCategories": [
      {
        "name": "Culture & Heritage",
        "code": "CULTURE_HERITAGE",
        "image": "https://cdn.delite24.in/.../culture_heritage.png",
        "subCategories": [
          { "name": "Museum / Galleries" },
          { "name": "Handicrafts Tour" },
          { "name": "Weaving Tour" }
        ]
      },
      // ... more categories
    ]
  }
}

Sub-category name values (e.g., "Museum / Galleries") can be passed as the subCategory query parameter in GET /items for deeper filtering. Results also cached for 6 hours.

← PreviousAuthentication Next →Cities & Locations