Back to Tools

get_availability_hold

read:bookings

Get the status of a slot hold for the current session.

Input Parameters

Parameters

PropertyTypeDescription
session_idrequiredstringSession identifier

Response

Response Schema

PropertyTypeDescription
activerequiredbooleanWhether the hold is active
reservation_idrequiredstring | nullReservation UUID
expires_atrequiredstring | nullExpiry timestamp (ISO 8601)
remaining_msrequirednumberRemaining time in milliseconds

Example

Requestjson
{
  "type": "tool",
  "name": "get_availability_hold",
  "params": {
    "session_id": "session-123"
  }
}
Responsejson
{
  "success": true,
  "data": {
    "active": true,
    "reservation_id": "reservation-uuid",
    "expires_at": "2026-01-15T18:15:00Z",
    "remaining_ms": 540000
  }
}

cURL Example

curl -X POST https://app.bizily.io/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{\n  "type": "tool",\n  "name": "get_availability_hold",\n  "params": {\n    "session_id": "session-123"\n  }\n}'