List Boat Fees

GET/boats/:id/fees

Retrieve all fees for a boat, filtered by its active pricing source. Fees are ordered by sort_order.

Path Parameters

Parameter	Type	Description
`id`	string	Boat ID (UUID)

Query Parameters

Parameter	Type	Required	Description
`start`	string	No	Start date (YYYY-MM-DD) -- filter to fees valid in this range
`end`	string	No	End date (YYYY-MM-DD) -- filter to fees valid in this range

When start and end are both provided, only fees that overlap the date range are returned. Fees with no valid_from/valid_to dates are always included.

Request

curl https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/fees

With date range filter:

curl "https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/fees?start=2024-07-01&end=2024-07-14"

Response

Returns an array of fee objects.

[
  {
    "id": "fee-1a2b3c...",
    "boat_id": "550e8400-e29b-41d4-a716-446655440000",
    "description": "Cleaning fee",
    "amount": 75,
    "period": "per_booking",
    "required": true,
    "category": null,
    "on_request": false,
    "sort_order": 0,
    "source": "direct",
    "source_id": null,
    "valid_from": null,
    "valid_to": null,
    "amount_is_percentage": false,
    "calculation_type": null,
    "min_duration": null,
    "max_duration": null,
    "created_at": "2024-01-15T10:00:00Z"
  },
  {
    "id": "fee-4d5e6f...",
    "boat_id": "550e8400-e29b-41d4-a716-446655440000",
    "description": "Captain",
    "amount": 150,
    "period": "per_day",
    "required": false,
    "category": "crew",
    "on_request": true,
    "sort_order": 1,
    "source": "direct",
    "source_id": null,
    "valid_from": "2024-06-01",
    "valid_to": "2024-09-30",
    "amount_is_percentage": false,
    "calculation_type": null,
    "min_duration": null,
    "max_duration": null,
    "created_at": "2024-01-15T10:00:00Z"
  }
]

Response Fields

Field	Type	Description
`id`	string	Fee ID (UUID)
`boat_id`	string	Boat this fee belongs to
`description`	string	Fee name/description
`amount`	number	Fee amount in USD (or percentage if `amount_is_percentage` is true)
`period`	string	Billing period (see below)
`required`	boolean	If true, fee is mandatory for every booking
`category`	string \| null	Fee category (e.g., `crew`, `equipment`)
`on_request`	boolean	If true, fee must be requested separately
`sort_order`	integer	Display order
`source`	string	Pricing source (`direct`, `nausys`, or `mmk`)
`source_id`	string \| null	External source identifier
`valid_from`	string \| null	Start date of validity period (YYYY-MM-DD)
`valid_to`	string \| null	End date of validity period (YYYY-MM-DD)
`amount_is_percentage`	boolean	Whether `amount` is a percentage rather than a fixed value
`calculation_type`	string \| null	How the fee is calculated
`min_duration`	integer \| null	Minimum booking duration (days) for this fee to apply
`max_duration`	integer \| null	Maximum booking duration (days) for this fee to apply
`created_at`	string	ISO 8601 timestamp

Fee Periods

Period	Description
`per_booking`	Charged once per booking
`per_day`	Multiplied by the number of rental days
`per_person`	Charged per guest
`per_person_per_day`	Per guest per day
`per_person_per_night`	Per guest per night
`per_week`	Charged per week
`one_way`	One-way delivery fee