List Your Fleet

GET/dashboard/boats

List the boats of the companies you belong to — unpublished boats included, which List Boats does not return. This is the call to find an imported boat that is not live yet, and to see what Update Boat changed. Newest boats come first.

Authentication

Requires one of:

API key: X-API-Key header with your API key. This is the way to call it from your own systems.
Session: a signed-in charter.boats session — what the dashboard uses from the browser. Outside charter.boats a request without a key is stopped by bot protection (HTML 403), so integrations should use the key.

Query Parameters

Parameter	Type	Required	Description
`company_id`	string	No	The company whose boats to list. If you are not a member of it, the response is an empty array. Without it, the boats of every company your account belongs to are listed; each record's `company_id` says whose it is

Request

curl https://charter.boats/api/dashboard/boats?company_id=COMPANY_UUID \
  -H "X-API-Key: YOUR_API_KEY"

Response

An array of boat records:

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "BALI Catspace - Luxury Catamaran",
    "boat_type": "catamaran",
    "capacity": 8,
    "company_id": "company-uuid",
    "location_id": 11336,
    "pricing_source": "direct",
    "is_published": false,
    "created_at": "2026-10-08T09:12:44.000Z",
    "images": [
      { "id": "img-uuid", "url": "https://example.com/exterior.jpg", "category": null, "is_primary": true, "is_active": true, "sort_order": 0 }
    ]
  }
]

Each record carries these fields:

Group	Fields
Identity	`id`, `title`, `description`, `boat_type`, `model`, `year`, `company_id`, `location_id`, `manufacturer_id`
Size	`length_ft`, `capacity`, `cabins`, `crew_cabins`, `berths`, `toilets`
Price	`price_per_day`, `price_from`, `price_to`, `original_price_per_day`, `discount_percentage`, `discount_label`, `pricing_source`, `security_deposit`
Charter terms	`rental_type`, `charter_day`, `check_in_periods`, `checkin_time`, `checkout_time`, `min_charter_days`, `instant_book`
State	`is_published`, `created_at`, `updated_at`, `average_rating`, `review_count`
Connected platforms	`mmk_yacht_id`, `nausys_yacht_id`, `mmk_sync_status`, `nausys_sync_status`
Images	`images[]` — `id`, `url`, `category`, `is_primary`, `is_active`, `sort_order`

The fields mean what they mean on Get Boat.

Errors

Status	Message
`401`	Invalid API key — a key that belongs to no account
`401`	Invalid API key format — a malformed key
`401`	Authentication required — no key and no signed-in session