POI Categories

Endpoint

GET /pois/categories

Description

Returns all available point-of-interest categories with their counts and metadata. Useful for building category filter UIs.

Authentication

No authentication required for server-side requests — this is a public read endpoint. (A key is only needed for cross-origin calls made from a browser on another domain; see Authentication.)

Example Request

curl "https://charter.boats/api/pois/categories"

Example Response

{
  "categories": [
    {
      "category": "restaurant",
      "count": 608,
      "label": "Restaurants & Cafes",
      "icon": "utensils",
      "description": "Restaurants, cafes, bars, pubs"
    },
    {
      "category": "grocery",
      "count": 191,
      "label": "Grocery & Food Shops",
      "icon": "shopping-cart",
      "description": "Supermarkets, convenience stores, bakeries, butchers"
    },
    {
      "category": "bank",
      "count": 50,
      "label": "Banks & ATMs",
      "icon": "credit-card",
      "description": "Banks, ATMs, currency exchange"
    },
    {
      "category": "pharmacy",
      "count": 43,
      "label": "Pharmacies",
      "icon": "pills",
      "description": "Pharmacies and chemists"
    },
    {
      "category": "parking",
      "count": 42
    },
    {
      "category": "entertainment",
      "count": 33,
      "label": "Entertainment",
      "icon": "star",
      "description": "Attractions, museums, nightlife"
    }
  ]
}

Counts reflect only currently active, ingested POIs and change over time. Categories without metadata in the catalog (for example parking) come back with just category and count — no label, icon, or description.

Response Fields

Field	Type	Description
`categories`	array	List of categories sorted by count (descending)
`categories[].category`	string	Category key (use in search filters)
`categories[].count`	number	Number of POIs in this category
`categories[].label`	string\|undefined	Human-readable label (omitted for categories without catalog metadata)
`categories[].icon`	string\|undefined	Icon name (Lucide icons; omitted when no metadata)
`categories[].description`	string\|undefined	Category description (omitted when no metadata)

Available Categories

Key	Label
`grocery`	Grocery & Food Shops
`restaurant`	Restaurants & Cafes
`fuel`	Fuel Stations
`chandlery`	Chandlery & Marine
`pharmacy`	Pharmacies
`bank`	Banks & ATMs
`laundry`	Laundry
`entertainment`	Entertainment
`water`	Water Points
`ice`	Ice
`fishing`	Fishing Supplies
`provisioning`	Provisioning
`parking`	Parking (no catalog metadata)
`other`	Other