Rate check

Replays a rateKey from a search, verifies the offer is still sellable and guarantees the price for 10 minutes.

POST/v1/{code}/checkrate

Request

JSON body

Name
rateKey
Type
string
Description
Offer key returned by Availability, to be replayed as-is.

Behaviour

Response identical to the search offer, with expiresAt set 10 minutes ahead.
Within this window, POST /bookings with the same rateKey honours the guaranteed price.
After expiresAt: 422 rate_expired — run search + checkrate again.

POST

/v1/1000/checkrate

curl -s -X POST "https://partners.bravebooking.net/v1/1000/checkrate" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "rateKey": "rk_x9F2kQ8example" }'

Response

{
  "rateKey": "rk_x9F2kQ8example",
  "hotel": { "id": 1803258, "name": "Villa Demo Stays" },
  "room": { "id": "18", "name": "Chambre Deluxe Vue Mer" },
  "boarding": { "id": 16, "name": "Petit-déjeuner" },
  "checkIn": "2027-01-15",
  "checkOut": "2027-01-20",
  "price": { "amount": 500.0, "currency": "TND", "net": true },
  "cancellation": [
    { "from": "2026-12-15", "to": "2027-01-14", "type": "PERCENT", "value": 0 },
    { "from": "2027-01-14", "type": "PERCENT", "value": 100, "nature": "NO_SHOW" }
  ],
  "confirmation": "instant",
  "expiresAt": "2026-11-13T10:25:30+01:00"
}

Errors

Code	Meaning
`422 rate_expired`	The `rateKey` has expired: run a new search
`422 stop_sales`	Stop-sales since the search
`422 on_request_only`	The offer is no longer available for instant confirmation
`404 not_found`	`rateKey` unknown or issued for another partner