Partner API V1

Connections

A connection represents one Bolt property asking to integrate with one approved channel-manager partner. Partner credentials never grant access to properties that selected a different partner.

List connections

GET/connections
Returns only connections belonging to the authenticated partner. Use a status filter to discover new requests or reconcile existing ones.
Query parameterRequiredRulesDescription
statusNoPENDING, ACTIVE, REJECTED, PAUSED, or DISCONNECTEDFilters by the current connection state.
limitNoInteger from 1 to 100; default 100Maximum number of connections returned.
cursorNoOpaque string from the prior responseContinues listing after the previous page.
Request
curl --request GET \
  --url "$BASE_URL/connections?status=PENDING&limit=100" \
  --header "Authorization: Bearer <ACCESS_TOKEN>"
200 response
{
  "request_id": "req_example",
  "connections": [
    {
      "connection_id": "<CONNECTION_ID>",
      "status": "PENDING",
      "property": {
        "id": 123,
        "name": "Mountain View Resort",
        "city": "Manali",
        "country": "IN",
        "timezone": "Asia/Kolkata"
      },
      "external_property_id": null,
      "requested_at": "2026-08-05T07:00:00.000Z",
      "accepted_at": null,
      "rejected_at": null,
      "rejection_reason": null,
      "last_availability_sync_at": null,
      "capabilities": ["availability", "rates", "reservations"]
    }
  ],
  "next_cursor": null
}

Connection fields

FieldTypeMeaning
request_idstringTop-level correlation identifier for the API request.
connection_idstringStable Bolt connection identifier used in all connection-scoped paths.
statusstringCurrent lifecycle state. Treat values as case-sensitive.
propertyobjectBolt property summary. id is numeric; name, city, country, and timezone support matching.
external_property_idstring or nullPartner property identifier supplied when the connection is accepted.
requested_at, accepted_at, rejected_atISO 8601 string or nullConnection lifecycle timestamps in UTC.
rejection_reasonstring or nullPartner-supplied reason recorded when a connection is rejected.
last_availability_sync_atISO 8601 string or nullTime of the most recent availability request with at least one successful room-date entry.
capabilitiesstring arrayEnabled V1 capability. The current value is availability.
next_cursorstring or nullTop-level list cursor. Null means that no additional page exists.

When next_cursor is not null, send it unchanged as the next request's cursor. Do not parse, modify, or persist assumptions about the cursor format. A null value means there are no more results for that filter.

Next page
curl --request GET \
  --url "$BASE_URL/connections?status=PENDING&limit=100&cursor=<CURSOR>" \
  --header "Authorization: Bearer <ACCESS_TOKEN>"

Get one connection

GET/connections/{connectionId}
Returns the current state of one connection owned by the authenticated partner. A connection belonging to another partner is not exposed.
Request
curl --request GET \
  --url "$BASE_URL/connections/<CONNECTION_ID>" \
  --header "Authorization: Bearer <ACCESS_TOKEN>"
200 response
{
  "request_id": "req_example",
  "connection": {
    "connection_id": "<CONNECTION_ID>",
    "status": "ACTIVE",
    "property": {
      "id": 123,
      "name": "Mountain View Resort",
      "city": "Manali",
      "country": "IN",
      "timezone": "Asia/Kolkata"
    },
    "external_property_id": "<EXTERNAL_PROPERTY_ID>",
    "requested_at": "2026-08-05T07:00:00.000Z",
    "accepted_at": "2026-08-05T07:05:00.000Z",
    "rejected_at": null,
    "rejection_reason": null,
    "last_availability_sync_at": null,
    "capabilities": ["availability", "rates", "reservations"]
  }
}

Accept a pending connection

POST/connections/{connectionId}/accept
Accept only after matching the Bolt property to the correct property in your system.
Request
curl --request POST \
  --url "$BASE_URL/connections/<CONNECTION_ID>/accept" \
  --header "Authorization: Bearer <ACCESS_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "external_property_id": "<EXTERNAL_PROPERTY_ID>"
  }'
  • external_property_id is required and should remain stable for the life of the connection. It can contain at most 255 characters.
  • A successful acceptance changes the connection from PENDING to ACTIVE and records the acceptance time.
  • Repeating acceptance with the same external property ID returns the active connection without creating another connection.
  • Repeating acceptance with a different external property ID returns HTTP 409 CONNECTION_ALREADY_ACCEPTED.

Reject a pending connection

POST/connections/{connectionId}/reject
Reject when you cannot confidently match the Bolt property to a property in your system.
Request
curl --request POST \
  --url "$BASE_URL/connections/<CONNECTION_ID>/reject" \
  --header "Authorization: Bearer <ACCESS_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "reason": "PROPERTY_NOT_FOUND"
  }'

Only a PENDING connection can transition to REJECTED. The required reason can contain at most 255 characters and is stored with the connection. Repeating the same rejection and reason returns the current connection without creating another change.

Connection states

StatusMeaningPermitted partner actions
PENDINGThe property requested this partner but the partner has not completed matching.List, read, accept, or reject.
ACTIVEThe partner accepted the matched property.Read rooms and mappings, upsert mappings, and send availability.
REJECTEDThe partner could not accept the requested property.List and read only. Wait for a new property-side request.
PAUSEDSynchronization is temporarily suspended.List and read only. Do not send availability until ACTIVE again.
DISCONNECTEDThe property ended the connection.List and read only. Room and availability writes are rejected.

Connection discovery

Poll GET /connections?status=PENDING to discover new property requests and periodically reconcile ACTIVE, PAUSED, and DISCONNECTED states. Reservation changes use the separate signed webhook and pending-event recovery workflow; a disconnected connection is no longer readable for reservation data.

Do not infer access from a property ID

Always start from the authenticated partner's connection list. The API does not expose unrelated Bolt properties, property-owner details, bookings, guests, or payments.