API Reference

Introduction

The SalonBookIt API allows you to:

• Query business, services and professionals information
• Check schedule availability
• Create and manage bookings
• Manage customers and their points program
• Process payments with Stripe

Base URL

https://app.salonbookit.com/api/v1

Response format

All responses follow the same format:

{
    "success": true,
    "data": {
        // Response data
    }
}

{
    "success": false,
    "error": {
        "code": "ERROR_CODE",
        "message": "Error description"
    }
}

Authentication

The API uses two authentication methods:

X-API-Key: hh_pub_live_abc123...

Authorization: Bearer eyJhbG...

See the complete authentication guide.

Available endpoints

Pagination

Endpoints that return lists support pagination:

Query parameters

Paginated response

{
    "success": true,
    "data": {
        "items": [...],
        "pagination": {
            "page": 1,
            "page_size": 20,
            "total_items": 45,
            "total_pages": 3,
            "has_next": true,
            "has_prev": false
        }
    }
}

Filters

Many endpoints support filters via query parameters. Check each endpoint's documentation for available filters.

Example

GET /api/v1/servicios/?categoria=1&activo=true&lang=es

HTTP codes

See the complete error reference.