# Square Appointments (Bookings API) (slim)

> Square Appointments is Block's booking product for service businesses. Its Bookings API searches a seller's availability and creates, updates and cancels appointments, with location, team member and business booking profiles and custom attributes.

- Full: https://www.anchorterminal.com/tools/square-appointments.md (~7,000 tokens) · this version ~1,530 tokens · JSON https://www.anchorterminal.com/tools/square-appointments.json · canonical https://www.anchorterminal.com/tools/square-appointments
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-14

**B · 68.1/100 · rank #242 of 1076 · #1 in Restaurant & local bookings · not agent-ready · confidence medium**


Assessment: The Bookings API lets an agent working for a Square seller search availability and create, change and cancel appointments, with a public OpenAPI spec, appointment OAuth scopes and idempotency keys. It acts for the venue. Seller-level writes need Plus or Premium, services with a no-show fee can't be booked through it, and it hasn't changed since September 2024.

## Facts

- Kind: HTTP API · vendor: Block, Inc. · category: Restaurant & local bookings · legal entity: Block, Inc. · provenance 84/100
- Endpoint: `https://connect.squareup.com/v2/bookings` (HTTP, Streamable HTTP, stdio)
- Auth: OAuth or key · pricing: Freemium · x402: no · licence: Proprietary service under the Square Developer Terms of Service. The OpenAPI specification and MCP server are Apache 2.0
- Probe metrics: not measured yet (probes haven't run)
- Surface graded: The Bookings API and Booking Custom Attributes API at https://connect.squareup.com/v2/bookings, read from the guides, the OpenAPI spec and the pricing page on 14 October 2026
- Acts for: The venue (a Square seller). Buyer-level permissions let an app book for the seller's customers, limited to bookings the app created
- Booking cycle: SearchAvailability, CreateBooking, UpdateBooking, CancelBooking, RetrieveBooking and ListBookings, plus location, team member and business booking profiles
- Plans: Seller-level writes need Appointments Plus or Premium. Buyer-level bookings and seller-level reads work on the free plan
- Deposits and fees: Services with a non-zero no-show fee can't be booked through the API. Segments of a booking with a paid deposit can't be updated
- Webhooks: booking.created and booking.updated. Buyer-level apps get events only for bookings they created
- Rate limits: No numbers published for REST. 429 `RATE_LIMITED`, with exponential backoff and jitter advised
- Prices: Square Free free per month (plan); Square Plus $49 per month (plan); Square Premium $149 per month (plan)

- Scores: Reliability 55, Performance pending, Schema & documentation 89, Agent ergonomics 80, Security & auth 70, Payments & pricing 40, Task success pending, Maintenance & community 71, Transparency & trust 70 · total over the 7 assessed categories
- Why: Reliability, Graded on the hosted Bookings API, part of Square's REST API. · Schema & documentation, Public OpenAPI 3.0 spec in square/connect-api-specification covering all 24 booking operations (25). · Agent ergonomics, ListBookings takes `limit` and a cursor, and SearchAvailability takes a time range and segment filters. · Security & auth, OAuth with read and write scopes for appointments (`APPOINTMENTS_READ`, `APPOINTMENTS_WRITE`, `APPOINTMENTS_ALL_READ`… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, Square released API version 2026-09-16 on 16 September 2026, and the Bookings API is served under it. · Transparency & trust, Closed service under the Square Developer Terms (updated 10 September 2026).
- Sources: 14, open questions: 5, both in the full twin
- Capabilities: booking.appointments, booking.availability, booking.venue
- JSON: https://www.anchorterminal.com/api/v1/tools/square-appointments.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/square-appointments.svg` or a link to https://www.anchorterminal.com/tools/square-appointments from a page on squareup.com or one of its subdomains, or the README of github.com/square/connect-api-specification, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Act for the seller. This API books into one Square seller's calendar, not across businesses
2. Call RetrieveBusinessBookingProfile and check `support_seller_level_writes` before trying to create or cancel a seller-level booking
3. Call SearchAvailability first, then CreateBooking with the service variation ID and version, team member, location and customer
4. Send a fresh `idempotency_key` on each create, update or cancel, and pass `booking_version` when cancelling
5. Check `no_show_fee` on the service. A service with a non-zero fee must be booked by the customer elsewhere

## Connect

```bash
npx square-mcp-server start
```

```bash
curl https://connect.squareupsandbox.com/v2/bookings/availability/search \
  -X POST \
  -H 'Square-Version: 2026-09-16' \
  -H 'Authorization: Bearer {SANDBOX_ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{"query": {"filter": {"start_at_range": {"start_at": "2026-10-20T09:00:00Z", "end_at": "2026-10-21T09:00:00Z"}, "location_id": "{LOCATION_ID}"}}}'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/square-appointments

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| TableCheck API | C | 57.1 | booking.availability, booking.venue | https://www.anchorterminal.com/tools/tablecheck.min.md |
| Eat App Partner API | D | 53.4 | booking.availability, booking.venue | https://www.anchorterminal.com/tools/eat-app.min.md |
| TheFork B2B API | E | 43.6 | booking.availability, booking.venue | https://www.anchorterminal.com/tools/thefork.min.md |
| OpenTable APIs | E | 38.6 | booking.availability, booking.venue | https://www.anchorterminal.com/tools/opentable.min.md |
| SevenRooms | F | 17.7 | booking.venue, booking.availability | https://www.anchorterminal.com/tools/sevenrooms.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)