Get Location

Endpoint

GET /locations/:id

Description

Retrieve full details for a location (marina, anchorage, bay), including available boats, nearby points of interest grouped by category, images, amenities, and neighboring locations.

Authentication

No authentication required. This is a public endpoint.

Path Parameters

Parameter	Type	Description
`id`	number	Location ID

Example Request

curl "https://charter.boats/api/locations/4521"

Example Response

{
  "id": 4521,
  "name": "D-Marin Lefkas",
  "lat": 38.8335,
  "lon": 20.7068,
  "city": "Lefkada",
  "state": "Western Greece",
  "country": "Greece",
  "country_code": "GR",
  "harbour_category": "marina",
  "description": "Modern full-service marina on the east coast of Lefkada...",
  "image_url": "https://example.com/marina.jpg",
  "rating": 4.5,
  "rating_count": 28,
  "images": [
    {
      "id": "img-uuid-1",
      "url": "https://example.com/marina-1.jpg",
      "source": "Google Maps",
      "source_url": "https://maps.google.com/...",
      "attribution": "Photo by contributor",
      "is_primary": true,
      "sort_order": 0
    }
  ],
  "boats": [
    {
      "id": "boat-uuid-1",
      "title": "Bavaria 46 Cruiser",
      "boat_type": "sailboat",
      "capacity": 10,
      "price_per_day": 285,
      "price_from": 250,
      "price_to": 450,
      "discount_percentage": 15,
      "discount_label": "Early booking",
      "original_price_per_day": 335,
      "instant_book": true,
      "manufacturer_name": "Bavaria",
      "primary_image": "https://example.com/boat.jpg"
    }
  ],
  "pois_by_category": {
    "restaurant": [
      {
        "id": "poi-uuid-1",
        "name": "Taverna Nidri",
        "category": "restaurant",
        "subcategory": "taverna",
        "cuisine": "greek",
        "rating": 4.7,
        "distance_meters": 350,
        "walking_time_minutes": 4
      }
    ],
    "grocery": [
      {
        "id": "poi-uuid-2",
        "name": "Mini Market Marina",
        "category": "grocery",
        "distance_meters": 120,
        "walking_time_minutes": 2
      }
    ]
  },
  "poi_count": 24,
  "amenities": [
    {
      "id": 1,
      "name": "Water",
      "icon": "droplet",
      "category": "basic"
    },
    {
      "id": 2,
      "name": "Electricity",
      "icon": "zap",
      "category": "basic"
    }
  ],
  "nearby_locations": [
    {
      "distance_nm": 5,
      "locations": [
        {
          "id": 4530,
          "name": "Nidri Bay",
          "lat": 38.7432,
          "lon": 20.7401,
          "country": "Greece",
          "harbour_category": "anchorage",
          "image_url": "https://example.com/nidri.jpg",
          "rating": 4.3,
          "boat_count": 12
        }
      ]
    },
    {
      "distance_nm": 15,
      "locations": [
        {
          "id": 4545,
          "name": "Vasiliki",
          "lat": 38.6309,
          "lon": 20.5897,
          "country": "Greece",
          "harbour_category": "harbour",
          "boat_count": 8
        }
      ]
    }
  ],
  "references": [
    {
      "title": "Google Maps",
      "url": "https://maps.google.com/...",
      "source_domain": "maps.google.com"
    }
  ]
}

Response Fields

Field	Type	Description
`id`	number	Location ID
`name`	string	Location name
`lat`	number	Latitude
`lon`	number	Longitude
`city`	string\|null	City
`state`	string\|null	State or region
`country`	string\|null	Country
`country_code`	string\|null	ISO country code
`harbour_category`	string\|null	Type of harbour
`description`	string\|null	Location description
`image_url`	string\|null	Primary image URL
`rating`	number\|null	Average rating
`rating_count`	number\|null	Number of ratings
`images`	array	All location images, sorted by `sort_order`
`boats`	array	Active boats at this location (max 20)
`boats[].manufacturer_name`	string\|null	Boat manufacturer
`boats[].primary_image`	string\|null	First boat image URL
`pois_by_category`	object	Nearby POIs grouped by category
`poi_count`	number	Total number of nearby POIs
`amenities`	array	Location amenities (water, electricity, etc.)
`nearby_locations`	array	Neighboring locations grouped by distance buckets
`nearby_locations[].distance_nm`	number	Distance in nautical miles
`nearby_locations[].locations`	array	Locations at this distance
`references`	array	Content sources and attributions

Error Responses

404 Not Found

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

Get Location

On this page