API Documentation

BookingScheduler API

Build powerful integrations with our RESTful API. Manage bookings, experiences, customers, and more programmatically.

Quick Links

API Reference

Complete endpoint documentation with examples

Authentication

Learn how to authenticate API requests

Webhooks

Receive real-time event notifications

Getting Started

Base URL

All API requests should be made to:

https://api.bookingscheduler.com/v1

Making Your First Request

Here's a simple example to get started:

curl -X GET "https://api.bookingscheduler.com/v1/experiences" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Format

All responses are returned in JSON format:

{
  "success": true,
  "data": {
    "id": "exp_123",
    "name": "City Walking Tour",
    "duration": 120
  }
}

Rate Limits

100
Requests per minute
10,000
Requests per day
99.9%
Uptime SLA

Rate limits are enforced per API key. Contact support for higher limits.

Error Handling

The API uses standard HTTP response codes to indicate success or failure:

200
Success
Request completed successfully
400
Bad Request
Invalid request parameters
401
Unauthorized
Invalid or missing API key
404
Not Found
Resource does not exist
429
Too Many Requests
Rate limit exceeded
500
Server Error
Something went wrong on our end

Error Response Format:

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Missing required field: name",
    "details": {
      "field": "name"
    }
  }
}

Need Help?

Our developer support team is here to help you build amazing integrations