Charter Boats API
Points of Interest

POI Categories

List all available POI categories with counts

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. This is a public endpoint.

Example Request

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

Example Response

{
  "categories": [
    {
      "category": "restaurant",
      "count": 2450,
      "label": "Restaurants & Cafes",
      "icon": "utensils",
      "description": "Restaurants, cafes, bars, pubs"
    },
    {
      "category": "grocery",
      "count": 1820,
      "label": "Grocery & Food Shops",
      "icon": "shopping-cart",
      "description": "Supermarkets, convenience stores, bakeries, butchers"
    },
    {
      "category": "fuel",
      "count": 640,
      "label": "Fuel Stations",
      "icon": "gas-pump",
      "description": "Marine fuel and regular fuel stations"
    },
    {
      "category": "pharmacy",
      "count": 380,
      "label": "Pharmacies",
      "icon": "pills",
      "description": "Pharmacies and chemists"
    },
    {
      "category": "bank",
      "count": 310,
      "label": "Banks & ATMs",
      "icon": "credit-card",
      "description": "Banks, ATMs, currency exchange"
    },
    {
      "category": "chandlery",
      "count": 95,
      "label": "Chandlery & Marine",
      "icon": "anchor",
      "description": "Boat supplies, marine equipment, yacht shops"
    },
    {
      "category": "laundry",
      "count": 72,
      "label": "Laundry",
      "icon": "shirt",
      "description": "Laundromats and dry cleaning"
    },
    {
      "category": "entertainment",
      "count": 540,
      "label": "Entertainment",
      "icon": "star",
      "description": "Attractions, museums, nightlife"
    }
  ]
}

Response Fields

FieldTypeDescription
categoriesarrayList of categories sorted by count (descending)
categories[].categorystringCategory key (use in search filters)
categories[].countnumberNumber of POIs in this category
categories[].labelstringHuman-readable label
categories[].iconstringIcon name (Lucide icons)
categories[].descriptionstringCategory description

Available Categories

KeyLabel
groceryGrocery & Food Shops
restaurantRestaurants & Cafes
fuelFuel Stations
chandleryChandlery & Marine
pharmacyPharmacies
bankBanks & ATMs
laundryLaundry
entertainmentEntertainment
waterWater Points
iceIce
fishingFishing Supplies
provisioningProvisioning
otherOther

Previous

Get POI

Next

List Passages

On this page