Initiate a spa booking

POST

/v3/api/business/reseller/bookings/spa

Validates eligibility for the requested services and checks whether a co-pay is required. If no co-pay is needed the booking is created immediately and the response contains the booking details. If a co-pay is required a booking session is returned — collect the co-pay from the client then call POST /bookings/spa/{sessionId}/confirm to complete the booking. Sessions expire after 24 hours. Idempotent — supply Idempotency-Key to safely retry. Alternatively, supply Bardge-Lookup-Token to initiate on behalf of a looked-up client without API key authentication.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

*/*

Booking created or co-pay session initiated

Body*/*

🟠400

🟠401

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v3/api/business/reseller/bookings/spa' \
--header 'Bardge-Lookup-Token: lkpt_abc123' \
--header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "date": "2026-05-10",
    "time": "14:00",
    "spa_id": "prov_abc123",
    "service_ids": [
        "srv_abc123",
        "srv_def456"
    ],
    "client_id": "client_abc123",
    "first_name": "Ada",
    "last_name": "Okafor",
    "user_pass_id": "brgpass_abc123"
}'

Response Example

201 - No co-pay required

{
    "object": "spa_booking_initiation",
    "copay_required": false,
    "booking_id": "booking_2a4f8e1b3c5d9f7a",
    "status": "PENDING",
    "service_name": "Deep Tissue Massage, Aromatherapy",
    "provider_name": "Zen Wellness Spa",
    "date": "2026-05-10",
    "time": "14:00",
    "scheduled_for": 1746878400,
    "created": 1746700000,
    "message": "Appointment booked successfully"
}

Modified at 2026-05-21 13:30:24

Confirm a class booking

Confirm a spa booking