Create Boat Fee

POST/boats/:id/fees

Add a new fee to a boat listing. Requires authentication as a company member for the boat. The fee is automatically assigned the next sort_order value.

Authentication

X-API-Key: cb_live_xxxxx

Path Parameters

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

Request Body

Field	Type	Required	Description
`description`	string	Yes	Fee name (e.g., "Cleaning fee")
`amount`	number	Yes	Fee amount in USD
`period`	string	Yes	Billing period (see below)
`required`	boolean	No	Default: `true`. Whether the fee is mandatory.
`category`	string	No	Fee category (e.g., `crew`, `equipment`)
`on_request`	boolean	No	Whether the fee must be requested separately
`valid_from`	string	No	Start date of validity (YYYY-MM-DD)
`valid_to`	string	No	End date of validity (YYYY-MM-DD)

Valid 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

Request

curl -X POST https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/fees \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cb_live_xxxxx" \
  -d '{
    "description": "Captain",
    "amount": 150,
    "period": "per_day",
    "required": false,
    "category": "crew",
    "on_request": true,
    "valid_from": "2024-06-01",
    "valid_to": "2024-09-30"
  }'

Response

Returns the created fee object.

{
  "id": "fee-7g8h9i...",
  "boat_id": "550e8400-e29b-41d4-a716-446655440000",
  "description": "Captain",
  "amount": 150,
  "period": "per_day",
  "required": false,
  "category": "crew",
  "on_request": true,
  "sort_order": 2,
  "source": "direct",
  "source_id": null,
  "valid_from": "2024-06-01",
  "valid_to": "2024-09-30",
  "amount_is_percentage": null,
  "calculation_type": null,
  "min_duration": null,
  "max_duration": null,
  "created_at": "2024-01-20T14:30:00Z"
}

Errors

Status	Message
`400`	Description, amount, and period are required
`400`	Period must be one of: per_booking, per_day, per_person, per_person_per_day, per_person_per_night, per_week, one_way
`404`	Boat not found

Common Fee Examples

Description	Amount	Period	Required
Cleaning fee	75	per_booking	Yes
Captain	150	per_day	No
Fuel deposit	200	per_booking	Yes
Water toys	100	per_day	No
Fishing gear	50	per_booking	No
Transit log	30	one_way	Yes

Create Boat Fee

On this page