Initiate a class booking

Validates eligibility for the requested class and returns one of three outcomes:

Booked immediately — the gym tier is covered by the client's pass and visits are available. The booking is created and returned.

Additional visits required (additional_visits_required: true) — the gym tier is covered but the client's visit limit is reached. A session is returned with cost_per_visit. Collect the amount for the desired number of visits from the client and call POST /bookings/class/{sessionId}/confirm with number_of_visits and duration.

Co-pay required (copay_required: true) — the gym tier is not covered by the pass. A session and all available co-pay packages are returned. Collect the co-pay from the client, select a package, and call POST /bookings/class/{sessionId}/confirm with copay_package_id.

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.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location '/v3/api/business/reseller/bookings/class' \ --header 'Bardge-Lookup-Token: lkpt_abc123' \ --header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "class_instance_id": "ci_abc123", "client_id": "client_abc123", "first_name": "Ada", "last_name": "Okafor", "user_pass_id": "brgpass_abc123" }'

{ "object": "class_booking_initiation", "copay_required": false, "additional_visits_required": false, "booking_id": "booking_3b5g9f2d4c8e1a7b", "status": "PENDING", "class_name": "Morning Yoga", "provider_name": "FitZone Lagos", "date": "2026-05-20", "time": "07:00", "scheduled_for": 1747724400, "visits_deducted": 1, "created": 1747700000, "message": "Class booked successfully" }

Request

Responses