API Documentation

Build powerful integrations with the HAIRVANA.IO API. Access all your salon data programmatically and create custom workflows.

API Version: v1.0|Base URL: https://api.hairvana.io

🔐

Secure Authentication

OAuth 2.0 and API key authentication with role-based access control

⚡

Real-time Webhooks

Get instant notifications for bookings, payments, and client updates

📊

Rate Limiting

5,000 requests/hour for Pro plans, 20,000 for Enterprise

🌐

RESTful Design

Clean, predictable API design following REST best practices

Quick Start

1. Get Your API Key

Settings → Integrations → API Keys → Generate New Key

2. Make Your First Request

curl -X GET "https://api.hairvana.io/v1/appointments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

3. Parse the Response

{
  "data": [
    {
      "id": "apt_12345",
      "client_id": "cli_67890",
      "stylist_id": "sty_11111",
      "service": "Color & Cut",
      "start_time": "2026-03-05T14:00:00Z",
      "duration": 120,
      "status": "confirmed"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 234
  }
}

Available Endpoints

GET/api/v1/appointments

Retrieve all appointments with optional filters

POST/api/v1/appointments

Create a new appointment

GET/api/v1/clients

List all clients with pagination support

POST/api/v1/clients

Add a new client to your database

PUT/api/v1/clients/:id

Update an existing client's information

DELETE/api/v1/clients/:id

Remove a client from your database

📖 Full Documentation

Complete API reference with examples in multiple languages

Read Docs →

🧪 API Playground

Test API calls directly in your browser without writing code

Try It →

💻 Code Examples

Sample implementations in JavaScript, Python, Ruby, and PHP

View Examples →

Need Help with Integration?

Our developer support team can help you build custom integrations or troubleshoot API issues.