API Reference

Build powerful integrations with our comprehensive API documentation.

Get Started View Full Documentation

Getting Started

Welcome to the BookingPro API! Our API follows REST principles and uses standard HTTP response codes, authentication, and verbs.

Base URL

https://api.bookingpro.com/v1

Making Your First Request

                            GET /bookings HTTP/1.1
                            Host: api.bookingpro.com
                            Authorization: Bearer YOUR_API_KEY
                            Accept: application/json

Authentication

Authenticate your account by including your API key in the Authorization header.

                            Authorization: Bearer YOUR_API_KEY

Keep your API keys secure

Never share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

Rate Limiting

Rate limits are applied per API key:

  • Free plan: 100 requests per minute
  • Pro plan: 1,000 requests per minute
  • Business plan: 10,000 requests per minute

Checking Your Rate Limit Status

                            X-RateLimit-Limit: 100
                            X-RateLimit-Remaining: 75
                            X-RateLimit-Reset: 1621533600

Bookings

Create, retrieve, update, and delete bookings programmatically.

Create a Booking

                            POST /bookings HTTP/1.1
                            Content-Type: application/json
                            Authorization: Bearer YOUR_API_KEY
                            
                            {
                                "service_id": "svc_123",
                                "start_time": "2023-06-15T14:00:00Z",
                                "customer": {
                                    "name": "John Doe",
                                    "email": "john@example.com"
                                }
                            }

List Bookings

                            GET /bookings?start_date=2023-06-01&end_date=2023-06-30 HTTP/1.1
                            Authorization: Bearer YOUR_API_KEY

Webhooks

Receive real-time notifications about events in your BookingPro account.

Available Events

  • booking.created - A new booking was created
  • booking.updated - A booking was updated
  • booking.cancelled - A booking was cancelled

Example Webhook Payload

                            {
                                "event": "booking.created",
                                "created": "2023-05-20T10:30:00Z",
                                "data": {
                                    "id": "book_xyz",
                                    "status": "confirmed",
                                    "start_time": "2023-06-15T14:00:00Z"
                                }
                            }