List Boats

GET/boats

Retrieve a list of boats with optional filters for search, type, capacity, and price.

Query Parameters

Parameter	Type	Description
`q`	string	Search query. Matches city, state, and title
`type`	string	Filter by boat type
`guests`	integer	Minimum guest capacity
`priceMin`	number	Minimum hourly price (USD)
`priceMax`	number	Maximum hourly price (USD)
`instantBook`	boolean	Filter to instant-bookable boats
`sortBy`	string	Sort order: `recommended`, `price-low`, `price-high`

Boat Types

sailboat, yacht, pontoon, fishing, catamaran, speedboat, houseboat, jetski, other

Request

# List all boats
curl https://charter.boats/api/boats
 
# Search for boats in Miami
curl "https://charter.boats/api/boats?q=Miami"
 
# Filter by type and capacity
curl "https://charter.boats/api/boats?type=catamaran&guests=6"
 
# Price range with sorting
curl "https://charter.boats/api/boats?priceMin=100&priceMax=500&sortBy=price-low"

Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Luxury Catamaran",
    "description": "Beautiful 40ft catamaran...",
    "boat_type": "catamaran",
    "capacity": 8,
    "length_ft": 40,
    "year": 2023,
    "location_city": "Miami",
    "location_state": "Florida",
    "price_per_hour": 350,
    "price_per_day": 2500,
    "instant_book": true,
    "is_active": true,
    "is_published": true,
    "images": [
      {
        "id": "img-1",
        "url": "https://...",
        "is_primary": true,
        "sort_order": 0
      }
    ],
    "amenities": [
      {
        "id": "1",
        "name": "WiFi",
        "icon": "wifi",
        "category": "entertainment"
      }
    ]
  }
]

Response Fields

Field	Type	Description
`id`	string	Unique boat identifier (UUID)
`title`	string	Boat name
`boat_type`	string	Type of boat
`capacity`	integer	Maximum guests
`price_per_hour`	number	Hourly rate in USD
`price_per_day`	number	Daily rate in USD
`location_city`	string	City location
`location_state`	string	State/country
`images`	array	Array of image objects
`amenities`	array	Array of amenity objects

List Boats

Query Parameters

Boat Types

Request

Response

Response Fields

On this page