API REFERENCE

OVERVIEW

The BarberBoost REST API lets you read and write data in your shop programmatically — integrate with your own systems, build custom workflows, or sync with third-party tools.

All requests and responses use JSON. Dates are returned in ISO 8601 format (2026-04-25T14:00:00Z).

AUTHENTICATION

Authenticate using a Bearer token in the Authorization header. Generate your API key from Settings → Account → API Keys.

curl https://barberboost.app/api/v1/bookings \
  -H "Authorization: Bearer bb_live_xxxxxxxxxxxxxxxxxxxx"

Keep your API key secret — treat it like a password. Rotate it from your settings at any time. Each shop has one API key.

RATE LIMITS

Requests are limited to 300 per minute per API key. Rate limit headers are included on every response:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1745600460

When you exceed the limit, requests return 429 Too Many Requests. Back off and retry after the time indicated in X-RateLimit-Reset.

BOOKINGS

Retrieve, create, and cancel bookings in your shop.

curl https://barberboost.app/api/v1/bookings?date=2026-04-25 \
  -H "Authorization: Bearer bb_live_xxxx"

{
  "data": [
    {
      "id": "bkg_01jvz3m8xk",
      "client": { "id": "clt_01jvz2b", "name": "Marcus Reid", "phone": "+447700900123" },
      "service": { "id": "svc_01jvz1a", "name": "Fade & Beard", "duration": 45, "price": 2500 },
      "staff": { "id": "stf_01jvz0f", "name": "Jordan" },
      "starts_at": "2026-04-25T14:00:00Z",
      "ends_at": "2026-04-25T14:45:00Z",
      "status": "confirmed"
    }
  ],
  "total": 1
}

curl -X POST https://barberboost.app/api/v1/bookings \
  -H "Authorization: Bearer bb_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "clt_01jvz2b",
    "service_id": "svc_01jvz1a",
    "staff_id": "stf_01jvz0f",
    "starts_at": "2026-04-26T10:00:00Z"
  }'

curl -X DELETE https://barberboost.app/api/v1/bookings/bkg_01jvz3m8xk \
  -H "Authorization: Bearer bb_live_xxxx"

CLIENTS

Read and manage your client database.

SERVICES

Read your service menu.

STAFF

Read staff profiles and availability.

ERRORS

The API uses standard HTTP status codes. Errors include a machine-readable code and a human-readable message.

{
  "error": {
    "code": "SLOT_UNAVAILABLE",
    "message": "The requested time slot is no longer available."
  }
}