bookings

Name: Bizily
Price: 49.00 USD
Rating: 4.8 (150 reviews)

read:bookings

bizily://bookings

List and filter bookings/appointments. Includes customer info, services booked, assigned team members, and timing. Supports filtering by status, date range, customer, or assignee.

Parameters

Input Parameters

Property	Type	Description
`status`	`string[]`	Filter by status (pending, confirmed, completed, cancelled, no_show)
`customerId`	`string`	Filter by customer UUID
`assigneeId`	`string`	Filter by team member UUID
`serviceId`	`string`	Filter by service UUID
`startDate`	`string`	Filter from date (ISO 8601)
`endDate`	`string`	Filter to date (ISO 8601)
`upcoming`	`boolean`	Convenience filter for dates >= now
`page`	`number`(default: 1)	Page number
`limit`	`number`(default: 20)	Results per page (1-100)

Response

Response Schema

Property	Type	Description
`bookings`required	`Booking[]`	Array of booking objects
`pagination`required	`Pagination`	Pagination metadata

Example

Requestjson

{
  "type": "resource",
  "name": "bookings",
  "params": {
    "upcoming": true,
    "status": ["confirmed"],
    "limit": 5
  }
}

Responsejson

{
  "success": true,
  "data": {
    "bookings": [
      {
        "id": "booking-uuid",
        "status": "confirmed",
        "startTime": "2024-01-20T14:00:00Z",
        "endTime": "2024-01-20T15:00:00Z",
        "customer": {
          "id": "customer-uuid",
          "name": "John Doe",
          "email": "john@example.com"
        },
        "services": [
          {
            "id": "service-uuid",
            "name": "Haircut",
            "price": 50,
            "duration": 60
          }
        ],
        "totalPrice": 50,
        "totalDuration": 60
      }
    ],
    "pagination": { ... }
  }
}

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": "resource",\n  "name": "bookings",\n  "params": {\n    "upcoming": true,\n    "status": ["confirmed"],\n    "limit": 5\n  }\n}'