Get POI

Endpoint

GET /pois/:id

Description

Retrieve full details for a point of interest, including nearby marina locations, other POIs grouped by category, images, content references, and special offers (for claimed businesses).

Send X-API-Key: YOUR_API_KEY on every call from outside charter.boats — without it Cloudflare bot protection answers with an HTML 403 page, not JSON. Call it from your server: this route sends no CORS headers. See Authentication.

Path Parameters

Parameter	Type	Description
`id`	string	POI ID (UUID format)

Example Request

curl "https://charter.boats/api/pois/7f1e2d6f-880f-43bd-ba12-d758894cb7a2" \
  -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "id": "7f1e2d6f-880f-43bd-ba12-d758894cb7a2",
  "osm_id": 2460057890,
  "osm_type": "node",
  "name": "Nelly's Cafe",
  "name_en": null,
  "category": "restaurant",
  "subcategory": "cafe",
  "lat": 37.5222284,
  "lon": 22.8614009,
  "address": null,
  "city": null,
  "country": null,
  "country_code": null,
  "phone": null,
  "website": null,
  "email": null,
  "opening_hours": null,
  "seasonal_hours": null,
  "is_seasonal": false,
  "description": "Nelly's Cafe Bar sits on the ground floor of a beachfront building...",
  "cuisine": null,
  "wikidata_id": null,
  "wikipedia_url": null,
  "image_url": "https://images.trvl-media.com/lodging/.../43828e49.jpg",
  "image_attribution": null,
  "image_source": "Hotels.com",
  "image_source_url": "https://www.hotels.com/ho616153/nelly-s-apartments-nafplio-greece/",
  "enriched_at": "2026-03-12T09:24:09.811+00:00",
  "osm_tags": {
    "name": "Nelly's Cafe",
    "amenity": "cafe",
    "outdoor_seating": "yes"
  },
  "last_updated": "2026-03-12T03:42:51.655018+00:00",
  "created_at": "2026-03-12T03:42:51.655018+00:00",
  "social_links": null,
  "claimed_by": null,
  "claimed_at": null,
  "images": [
    {
      "id": "50d25323-4f62-4376-8875-147b393d394f",
      "url": "https://images.trvl-media.com/lodging/.../43828e49.jpg",
      "source": "Hotels.com",
      "source_url": "https://www.hotels.com/ho616153/nelly-s-apartments-nafplio-greece/",
      "attribution": null,
      "is_primary": true,
      "sort_order": 0,
      "storage_path": null
    }
  ],
  "nearby_locations": [
    {
      "id": 20751,
      "slug": "asini-harbour",
      "name": "Asini Harbour",
      "lat": 37.5196608,
      "lon": 22.8662526,
      "city": "Municipal Unit of Asini",
      "municipality": "Municipality of Nafplio",
      "state": "Peloponnese Region",
      "country": "Greece",
      "capacity": null,
      "max_draft": null,
      "vhf_channel": null,
      "website": null,
      "phone": null,
      "image_url": null,
      "rating": null,
      "distance_meters": 514,
      "walking_time_minutes": 7
    },
    {
      "id": 23496,
      "slug": "tolo-harbour-dock",
      "name": "Tolo Harbour Dock",
      "lat": 37.514298,
      "lon": 22.856677,
      "city": "Municipal Unit of Asini",
      "municipality": "Municipality of Nafplio",
      "state": "Peloponnese Region",
      "country": "Greece",
      "capacity": null,
      "max_draft": null,
      "vhf_channel": null,
      "website": null,
      "phone": null,
      "image_url": "https://res.cloudinary.com/hury8ejiw/image/upload/v1617277933/gwyjzsrrtzcqmnzwzlwk.jpg",
      "rating": 3.3,
      "distance_meters": 975,
      "walking_time_minutes": 12
    }
  ],
  "pois_by_category": {
    "restaurant": [
      {
        "id": "7e102429-dc1e-44d2-a33e-f5f3b0e9db54",
        "name": "Carnayio Seaside Restaurant",
        "name_en": null,
        "category": "restaurant",
        "subcategory": "restaurant",
        "image_url": "https://images.happycow.net/venues/1024/29/24/hcmp292481_1529088.jpeg",
        "distance_meters": 137,
        "walking_time_minutes": 2
      }
    ]
  },
  "references": [
    {
      "title": "Hotels.com",
      "url": "https://www.hotels.com/ho616153/nelly-s-apartments-nafplio-greece/",
      "source_domain": "hotels.com"
    }
  ],
  "special_offers": []
}

special_offers is only populated for claimed businesses; it is an empty array otherwise. POIs carry no rating or rating_count — the fields were withdrawn and then removed, because they were scraped from a search engine with no check that the result was this business. Ratings on nearby_locations are unaffected: those are marinas, and a knowledge panel for a named marina is answering about that marina.

Response Fields

Field	Type	Description
`id`	string	POI ID (UUID)
`osm_id`	number\|null	OpenStreetMap ID
`osm_type`	string\|null	OSM type (`node`, `way`, `relation`)
`name`	string	Name (local language), or the POI's type where OSM gave it no name (`"Parking"`, `"Pharmacy"`). Never null — use `category` + `subcategory` to render your own label instead.
`name_en`	string\|null	English name
`category`	string	POI category
`subcategory`	string\|null	More specific category
`lat`	number	Latitude
`lon`	number	Longitude
`address`	string\|null	Street address
`city`	string\|null	City
`country`	string\|null	Country
`country_code`	string\|null	ISO country code (lowercase when present)
`phone`	string\|null	Phone number
`website`	string\|null	Website URL
`email`	string\|null	Email address
`opening_hours`	string\|null	Opening hours (OSM format)
`seasonal_hours`	string\|null	Seasonal opening hours
`is_seasonal`	boolean\|null	Whether the business is seasonal
`description`	string\|null	Description (markdown)
`cuisine`	string\|null	Cuisine type (restaurants)
`wikidata_id`	string\|null	Wikidata entity ID
`wikipedia_url`	string\|null	Wikipedia page URL
`image_url`	string\|null	Primary image URL
`image_attribution`	string\|null	Attribution for `image_url`
`image_source` / `image_source_url`	string\|null	Source label / source page for the primary image
`enriched_at`	string\|null	Timestamp of last AI enrichment
`osm_tags`	object\|null	Raw OpenStreetMap tags
`last_updated` / `created_at`	string	Row timestamps
`social_links`	object\|null	Social media links (when known)
`claimed_by` / `claimed_at`	string\|null	Set when a business owner has claimed the POI
`images`	array	Active POI images, sorted by `sort_order` (`url`, `source`, `source_url`, `attribution`, `is_primary`, `storage_path`). Our own copies are served from `https://media.charter.boats/`; if you receive one on another storage host, request the same path from `media.charter.boats`. Third-party image URLs are returned as-is
`nearby_locations`	array	Up to 4 closest published charter locations (marinas/harbours/bays), nearest first
`nearby_locations[].slug`	string\|null	Location slug — pass it to Get Location
`nearby_locations[].name`	string\|null	The location's stored name. Can be `null` for a place with no name — unlike Get Location, which substitutes the type label; render the type yourself
`nearby_locations[].state` / `.municipality`	string\|null	Region fields on each neighbor
`nearby_locations[].capacity` / `.max_draft` / `.vhf_channel`	mixed\|null	Marina facility fields
`nearby_locations[].distance_meters`	number	Distance from the POI
`nearby_locations[].walking_time_minutes`	number	Estimated walking time
`pois_by_category`	object	Other POIs at the nearest location (`nearby_locations[0]`), grouped by category, nearest to that location first; each carries `id`, `name` (never null — the type where unnamed), `name_en`, `category`, `subcategory`, `image_url`, `distance_meters`, `walking_time_minutes`. At most 100 in total, across all categories (a flat cap, not per category) — for the full set of one category use `/pois/search?location_id=…&category=…`
`references`	array	Content sources and attributions (`title`, `url`, `source_domain`)
`special_offers`	array	Active offers from claimed businesses (empty unless claimed)

Special Offer Fields

Field	Type	Description
`id`	string	Offer ID
`title`	string	Offer title
`description`	string\|null	Offer description
`discount_type`	string\|null	Type of discount (`percentage`, `fixed`, etc.)
`discount_value`	number\|null	Discount amount
`start_date`	string\|null	Start date (YYYY-MM-DD)
`end_date`	string\|null	End date (YYYY-MM-DD)
`coupon_code`	string\|null	Coupon code
`redeem_url`	string\|null	URL to redeem the offer
`terms_conditions`	string\|null	Terms and conditions
`cta_type`	string\|null	Call-to-action type: `book`, `order`, `learn_more`, `get_offer`, `call`, `shop` or `sign_up`
`cta_url`	string\|null	Call-to-action link
`media_url`	string\|null	Image or video attached to the offer

Error Responses

400 Bad Request

{
  "statusCode": 400,
  "message": "Invalid POI ID"
}

404 Not Found

{
  "statusCode": 404,
  "message": "POI not found"
}

Also returned for a POI that has been retired (for example a duplicate car park folded into its neighbour) — a retired POI is not served, even by its id.

Get POI

On this page