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}/acknowledge

Send {"status":"PROCESSED"} after your inventory and availability update succeeds. Repeating the request is safe.

Event shape

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
}

Version and snapshot rules

  • reservation.created is version 1 with previous = null.
  • reservation.modified increments the version and contains both the prior and current occupied room nights.
  • reservation.cancelled increments the version with the prior allocation and current = null.
  • Use reservation_id + reservation_version to ignore an older event that arrives after a newer one.

Curl examples

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"}'