Get Booking

GET/bookings/:id

Retrieve full details for a single booking, including boat info, company details, images, and a linked conversation ID (if one exists).

Requires session authentication. Accessible by the guest who made the booking or any member of the boat's company.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Booking ID (UUID)

Request

curl https://charter.boats/api/bookings/550e8400-e29b-41d4-a716-446655440000 \
  -H "Cookie: <session-cookie>"

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "boat_id": "boat-uuid",
  "guest_id": "user-uuid",
  "status": "confirmed",
  "start_at": "2026-07-12T17:00:00",
  "end_at": "2026-07-19T09:00:00",
  "guest_count": 6,
  "total_price": 4200,
  "service_fee": 45,
  "booking_source": "direct",
  "boat_title": "Luxury Catamaran",
  "company_id": "company-uuid",
  "company_name": "Adriatic Charters",
  "coupon_code": null,
  "coupon_discount": null,
  "referral_source": "direct",
  "hold_expires_at": "2026-06-01T11:15:00.000Z",
  "stripe_payment_intent_id": "pi_xxx",
  "created_at": "2026-06-01T10:30:00Z",
  "updated_at": "2026-06-01T10:45:00Z",
  "boat": {
    "id": "boat-uuid",
    "title": "Luxury Catamaran",
    "boat_type": "catamaran",
    "capacity": 10,
    "location": {
      "id": "location-uuid",
      "name": "ACI Marina Split",
      "city": "Split",
      "country": "Croatia"
    },
    "company": {
      "id": "company-uuid",
      "name": "Adriatic Charters",
      "slug": "adriatic-charters",
      "logo_url": "https://...",
      "email": "info@adriatic-charters.com",
      "phone": "+385911234567"
    },
    "images": [
      {
        "url": "https://...",
        "is_primary": true,
        "is_active": true
      }
    ]
  },
  "conversation_id": "conversation-uuid"
}

Response Fields

Field	Type	Description
`id`	string	Booking ID (UUID)
`boat_id`	string	Boat ID
`guest_id`	string	Guest's user ID
`status`	string	`pending`, `accepted`, `confirmed`, `completed`, `cancelled`
`start_at`	string	Charter start (ISO 8601 datetime)
`end_at`	string	Charter end (ISO 8601 datetime)
`guest_count`	integer	Number of guests
`total_price`	number	Charter price + fees (excludes service fee)
`service_fee`	number	Flat platform service fee
`booking_source`	string	`direct`, `nausys`, or `mmk`
`boat_title`	string	Snapshot of the boat title at booking time
`company_id`	string	Company ID
`company_name`	string	Snapshot of the company name at booking time
`coupon_code`	string	Applied coupon code, or `null`
`coupon_discount`	number	Coupon discount amount, or `null`
`hold_expires_at`	string	When the payment hold expires
`stripe_payment_intent_id`	string	Stripe PaymentIntent ID
`created_at`	string	When the booking was created
`boat`	object	Boat details including company and images
`boat.location`	object	Marina/base location with city and country
`boat.company`	object	Charter company details
`conversation_id`	string	Linked messaging conversation ID, or `null`

Errors

Status	Message
`400`	Booking ID is required
`401`	Authentication required
`403`	Not authorized to view this booking
`404`	Booking not found