List bookings

Paginated list of your partner's bookings, filterable by creation period and status. This is the sync endpoint: poll it regularly for creations and status changes.

GET/v1/{code}/bookings

Request

Query parameters

Name
from
Type
string
Description
ISO YYYY-MM-DD — minimum creation date (inclusive).
Name
to
Type
string
Description
ISO YYYY-MM-DD — maximum creation date (inclusive).
Name
status
Type
string
Description
Filter by status: confirmed, pending, cancelled, cancellation_in_progress.
Name
page
Type
integer
Description
Page number (default 1).
Name
perPage
Type
integer
Description
Page size (default 50, maximum 100).

Without from / to, the last 30 days are returned. Windows longer than 92 days are rejected (400).

GET

/v1/1000/bookings

curl -s "https://partners.bravebooking.net/v1/1000/bookings?from=2026-11-01&to=2026-11-30&perPage=50" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Accept: application/json"

Response

{
  "data": [
    {
      "reference": "BPG-2026-000123",
      "clientReference": "PARTNER-2026-000481",
      "status": "confirmed",
      "hotel": { "id": 1803258, "name": "Villa Demo Stays" },
      "checkIn": "2027-01-15",
      "checkOut": "2027-01-20",
      "amounts": { "total": 2500.0, "fees": 0.0, "currency": "TND" },
      "createdAt": "2026-11-13T10:16:02+01:00"
    }
  ],
  "meta": { "page": 1, "perPage": 50, "total": 1, "pages": 1 }
}

Full detail (guests, cancellation policy) is read via Booking detail with the reference.