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).

Authentication

No authentication required. This is a public endpoint.

Path Parameters

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

Example Request

curl "https://charter.boats/api/pois/a1b2c3d4-5678-90ab-cdef-1234567890ab"

Example Response

{
  "id": "poi-uuid-1",
  "osm_id": 987654321,
  "osm_type": "node",
  "name": "Taverna Nidri",
  "name_en": "Nidri Tavern",
  "category": "restaurant",
  "subcategory": "taverna",
  "lat": 38.8312,
  "lon": 20.7089,
  "address": "Waterfront Road",
  "city": "Lefkada",
  "country": "Greece",
  "country_code": "GR",
  "phone": "+30 2645 099999",
  "website": "https://example.com",
  "email": "info@example.com",
  "opening_hours": "Mo-Su 12:00-23:00",
  "is_seasonal": true,
  "description": "Traditional Greek taverna on the waterfront...",
  "cuisine": "greek",
  "image_url": "https://example.com/taverna.jpg",
  "rating": 4.7,
  "rating_count": 42,
  "images": [
    {
      "id": "img-uuid-1",
      "url": "https://example.com/taverna-1.jpg",
      "source": "Google Maps",
      "source_url": "https://maps.google.com/...",
      "attribution": "Photo by contributor",
      "is_primary": true,
      "sort_order": 0
    }
  ],
  "nearby_locations": [
    {
      "id": 4521,
      "name": "D-Marin Lefkas",
      "lat": 38.8335,
      "lon": 20.7068,
      "city": "Lefkada",
      "country": "Greece",
      "harbour_category": "marina",
      "image_url": "https://example.com/marina.jpg",
      "rating": 4.5,
      "distance_meters": 350,
      "walking_time_minutes": 4
    }
  ],
  "pois_by_category": {
    "grocery": [
      {
        "id": "poi-uuid-2",
        "name": "Mini Market Marina",
        "category": "grocery",
        "image_url": "https://example.com/market.jpg",
        "rating": 4.0,
        "distance_meters": 120,
        "walking_time_minutes": 2
      }
    ]
  },
  "references": [
    {
      "title": "Google Maps",
      "url": "https://maps.google.com/...",
      "source_domain": "maps.google.com"
    }
  ],
  "special_offers": [
    {
      "id": "offer-uuid-1",
      "title": "Happy Hour",
      "description": "50% off drinks 17:00-19:00",
      "discount_type": "percentage",
      "discount_value": 50,
      "start_date": "2026-06-01",
      "end_date": "2026-09-30",
      "terms_conditions": "Valid for dine-in only"
    }
  ]
}

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)
`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
`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
`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
`rating`	number\|null	Rating
`rating_count`	number\|null	Number of ratings
`images`	array	All POI images, sorted by `sort_order`
`nearby_locations`	array	Up to 4 closest marina/harbour locations
`nearby_locations[].distance_meters`	number	Distance from the POI
`nearby_locations[].walking_time_minutes`	number	Estimated walking time
`pois_by_category`	object	Other nearby POIs grouped by category (from nearest location)
`references`	array	Content sources and attributions
`special_offers`	array	Active offers from claimed businesses

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

Error Responses

400 Bad Request

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

404 Not Found

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

Get POI

On this page