Pardon our mess These API docs are a work in progress. Endpoints, examples, and behavior may change as we continue to develop the Partner API v2.

Partner API

Errors

Status codes, rate limits, and error payloads for Partner API v2.

Error envelope

{
  "success": false,
  "error": "Human-readable message"
}

Common status codes

StatusWhen
400Invalid parameters (bad dates, missing names, invalid phone, misconfigured calendar)
401Missing or invalid Bearer token
409Requested booking slot is no longer available
429Rate limit exceeded

Rate limits

  • GET .../availability (range and per-date): 60 requests / minute
  • POST .../bookings: 20 requests / minute

Limits are applied per client identity used by the rate limiter (typically IP). Reduce parallel polling and cache availability responses where you can.

Example messages

  • Invalid or missing token
  • Invalid date range. Use YYYY-MM-DD for from and to.
  • first_name and last_name are required
  • phone is required
  • This time slot is no longer available.