Partner API V1
Reservation events
Bolt writes an immutable inventory event in the same transaction as a confirmed booking change. Use the event ID for deduplication and reservation_version for ordering.
Notification is not processing completion
A successful webhook response only means the notification was received. Retrieve the event, apply its inventory change, update absolute availability, and acknowledge it explicitly.
GET
/reservation-events?status=PENDING&limit=100&cursor=...Returns events belonging only to the authenticated partner. PENDING means not acknowledged and includes undelivered, delivered, skipped, and dead-letter events. Results are ordered by created_at then event_id.
GET
/reservation-events/{eventId}Returns the immutable event, including inventory.previous and inventory.current snapshots.
POST
/reservation-events/{eventId}/acknowledgeSend {"status":"PROCESSED"} after your inventory and availability update succeeds. Repeating the request is safe.
Pending event
{
"event_id": "cm_evt_123",
"event_type": "reservation.modified",
"connection_id": "cm_connection_123",
"bolt_property_id": "789",
"reservation_id": "reservation_456",
"reservation_version": 2,
"created_at": "2026-08-05T10:30:00.000Z",
"webhook_delivery_status": "DELIVERED",
"delivery_attempts": 1
}reservation.createdis version 1 withprevious = null.reservation.modifiedincrements the version and contains both the prior and current occupied room nights.reservation.cancelledincrements the version with the prior allocation andcurrent = null.- Use
reservation_id + reservation_versionto ignore an older event that arrives after a newer one.
List, retrieve, acknowledge
BASE_URL="https://www.boltlabs.app/partner-api/v1"
TOKEN="partner-access-token"
curl -sS "$BASE_URL/reservation-events?status=PENDING&limit=100" -H "Authorization: Bearer $TOKEN"
curl -sS "$BASE_URL/reservation-events/cm_evt_123" -H "Authorization: Bearer $TOKEN"
curl -sS -X POST "$BASE_URL/reservation-events/cm_evt_123/acknowledge" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"status":"PROCESSED"}'