1. Bookings
Bardge API (V3)
  • Introduction
  • Authentication
  • Errors
  • Idempotent Requests
  • Pagination
  • Passes
    • Introduction
    • Get All Reseller Passes
      GET
    • Issue a pass
      POST
    • Update user's pass
      POST
    • Update user's pass expiry
      POST
    • Get User Pass Details
      GET
  • Providers
    • Introduction
    • Get providers
      GET
    • Get providers for a pass
      GET
  • Access Codes
    • Introduction
    • Generate dynamic access code
      POST
  • Bookings
    • Introduction
    • Get class categories
      GET
    • Get classes
      GET
    • Get class with instances
      GET
    • Initiate a class booking
      POST
    • Confirm a class booking
      POST
    • Initiate a spa booking
      POST
    • Confirm a spa booking
      POST
    • Get client bookings
      GET
    • Get booking status
      GET
    • Cancel a booking
      POST
  • Co-pay
    • Introduction
  • Credits
    • Introduction
    • Purchase credits
    • Get credit packages
  • Lookup
    • Introduction
    • Get issuers
    • Initiate a lookup
    • Verify a lookup
    • Get a client
    • Get client credits
  • Schemas
    • PasscodeV3Request
    • PurchaseSpaCoPayV3Request
    • LookupInitiateV3Request
    • ResellerV3PasscodeResponse
    • ErrorDetail
    • ResellerV3ErrorResponse
    • LookupV3Response
    • ResellerV3SpaCoPayPurchaseResponse
    • LookupVerifyV3Request
    • SpaCoPayQuoteV3Request
    • IssuePassV3Request
    • PassRef
    • ResellerV3SpaCoPayQuoteResponse
    • CategoryDetails
    • ResellerV3IssuedPassResponse
    • UpdateIssuedPassExpiryV3Request
    • ResellerV3IssuedPassMessageResponse
    • UpdateLookupEnabledRequest
    • UpdateIssuedPassV3Request
    • PurchaseGymCoPayV3Request
    • PurchaseCoPayPackageV3Request
    • PurchaseCreditsV3Request
    • ResellerV3GymCoPayPurchaseResponse
    • ResellerV3CreditPurchaseResponse
    • ResellerV3CoPayPurchaseResponse
    • RescheduleBookingV3Request
    • RefundInfo
    • PasscodeInfo
    • ResellerV3BookingResponse
    • BookSpaV3Request
    • ResellerV3SpaBookingInitiateResponse
    • BookClassV3Request
    • CopayOption
    • ResellerV3ProviderResponse
    • ResellerV3ClassBookingInitiateResponse
    • ResellerV3ServiceResponse
    • ConfirmClassBookingV3Request
    • ResellerV3SpaResponse
    • AccessCodeV3Request
    • ServicePreview
    • ResellerV3AccessCodeResponse
    • ResellerV3ListResponse
    • ResellerV3AccessCodeSessionResponse
    • ResellerV3AvailabilityResponse
    • ConfirmAccessCodeV3Request
    • ResellerV3ClientResponse
    • CategoryDetail
    • ResellerV3CreditsResponse
    • ResellerV3PassResponse
    • ResellerV3ClassInstanceResponse
    • ResellerV3ClassResponse
    • ResellerV3BookingStatusResponse
  1. Bookings

Get client bookings

GET
/v3/api/business/reseller/clients/{clientId}/bookings
Returns a paginated list of bookings for a specific client, optionally filtered by status and type.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Query Params

Responses

🟢200
*/*
Paginated list of bookings
Body*/*

🟠401
🟠403
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v3/api/business/reseller/clients/client_abc123/bookings?status=CONFIRMED&type=SPA&starting_after=undefined&ending_before=undefined&limit=10' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Success
{
    "object": "list",
    "data": [
        {
            "object": "booking",
            "id": "booking_2a4f8e1b3c5d9f7a",
            "status": "CONFIRMED",
            "type": "spa",
            "service_name": "Deep Tissue Massage",
            "provider_name": "Zen Wellness Spa",
            "date": "2026-05-10",
            "time": "14:00",
            "scheduled_for": 1746878400000,
            "credits_deducted": 5,
            "created": 1746700000000
        },
        {
            "object": "booking",
            "id": "booking_7c3e9f2b1d5a8e4c",
            "status": "COMPLETED",
            "type": "class",
            "class_name": "Morning Yoga Flow",
            "provider_name": "FitHub Lagos",
            "date": "2026-05-07",
            "time": "07:00",
            "scheduled_for": 1746594000000,
            "visits_deducted": 1,
            "created": 1746500000000
        }
    ],
    "has_more": false,
    "url": "/v3/api/business/reseller/clients/client_abc123/bookings",
    "message": "Bookings retrieved successfully"
}
Modified at 2026-05-21 13:30:24
Previous
Confirm a spa booking
Next
Get booking status
Built with