Booking detail

Returns the full state of a booking: status, guests, amounts, cancellation policy.

GET/v1/{code}/bookings/{ref}

Request

URL parameters

Name
ref
Type
string
Description
Gateway reference (e.g. BPG-2026-000123) received at creation.

Possible statuses (`status`)

Value	Meaning
`confirmed`	Confirmed
`pending`	On request, awaiting confirmation
`cancelled`	Cancelled
`cancellation_in_progress`	Cancellation in progress

GET

/v1/1000/bookings/BPG-2026-000123

curl -s "https://partners.bravebooking.net/v1/1000/bookings/BPG-2026-000123" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Accept: application/json"

Response

{
  "reference": "BPG-2026-000123",
  "clientReference": "PARTNER-2026-000481",
  "status": "confirmed",
  "hotel": {
    "id": 1803258,
    "name": "Villa Demo Stays",
    "city": { "id": 146070, "name": "La Marsa" },
    "address": "12 rue du Lac, La Marsa"
  },
  "checkIn": "2027-01-15",
  "checkOut": "2027-01-20",
  "rooms": [
    {
      "roomId": "18",
      "name": "Chambre Deluxe Vue Mer",
      "boarding": { "id": 16, "name": "Petit-déjeuner" },
      "adults": [{ "civility": "Mr", "firstName": "TEST-A", "lastName": "TEST-B" }],
      "children": [{ "firstName": "TEST-C", "lastName": "TEST-B", "age": 8 }]
    }
  ],
  "amounts": { "total": 2500.0, "fees": 0.0, "currency": "TND" },
  "cancellation": [
    { "from": "2026-12-15", "to": "2027-01-14", "type": "PERCENT", "value": 0 },
    { "from": "2027-01-14", "type": "PERCENT", "value": 100, "nature": "NO_SHOW" }
  ],
  "createdAt": "2026-11-13T10:16:02+01:00"
}

Errors

404 not_found if the reference is unknown or belongs to another partner.