Submit Damage Claim

POST/claims

Submit a damage claim for a completed or confirmed booking. Claims must be submitted within 48 hours of the booking's checkout time. Only one claim is allowed per booking.

Authentication

Requires authentication as the boat's company owner.

X-API-Key: cb_live_xxxxx

Request Body

Field	Type	Required	Description
`booking_id`	string	Yes	Booking ID (UUID)
`damage_type`	string	Yes	Type of damage
`description`	string	Yes	Detailed description of the damage
`claimed_amount`	number	Yes	Amount in USD (converted to cents internally)
`photos`	string[]	No	Array of photo URLs
`repair_estimate_url`	string	No	URL to repair estimate document
`checkin_report_url`	string	No	URL to check-in condition report
`checkout_report_url`	string	No	URL to check-out condition report
`additional_docs`	string[]	No	Array of additional document URLs

Damage Types

The damage_type field accepts any string. Common values:

scratch -- Scratch or scuff
dent -- Dent or impact damage
mechanical -- Mechanical damage
interior -- Interior damage
missing_item -- Missing equipment
other -- Other damage

Request

curl -X POST https://charter.boats/api/claims \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cb_live_xxxxx" \
  -d '{
    "booking_id": "booking-uuid-here",
    "damage_type": "scratch",
    "description": "Large scratch on starboard hull, approximately 2 feet long. Discovered during post-charter inspection.",
    "claimed_amount": 500,
    "photos": [
      "https://storage.example.com/claim-photo-1.jpg",
      "https://storage.example.com/claim-photo-2.jpg"
    ],
    "repair_estimate_url": "https://storage.example.com/estimate.pdf",
    "checkin_report_url": "https://storage.example.com/checkin.pdf",
    "checkout_report_url": "https://storage.example.com/checkout.pdf"
  }'

Response

{
  "success": true,
  "claim": {
    "id": "a1b2c3d4-...",
    "status": "pending_review",
    "claimed_amount": 50000,
    "submitted_at": "2024-01-20T14:30:00Z"
  }
}

Note: claimed_amount in the response is stored in cents (the input value multiplied by 100).

Response Fields

Field	Type	Description
`success`	boolean	Always `true` on success
`claim.id`	string	Claim ID (UUID)
`claim.status`	string	Initial status (`pending_review`)
`claim.claimed_amount`	integer	Claimed amount in cents
`claim.submitted_at`	string	ISO 8601 timestamp

Claim Statuses

Status	Description
`pending_review`	Awaiting review
`info_requested`	Additional information needed
`approved`	Full amount approved
`partially_approved`	Reduced amount approved
`declined`	Claim rejected
`resolved`	Claim completed

Errors

Status	Message
`400`	Missing required fields
`400`	Claims can only be filed for completed rentals
`400`	Claim deadline has passed. Claims must be submitted within 48 hours of checkout.
`400`	A claim already exists for this booking
`404`	Booking not found

Notifications

When a claim is submitted, email notifications are sent to:

The claims team at Charter Boats
The guest on the booking
The owner who filed the claim (confirmation)

Submit Damage Claim

On this page