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 class with instances

GET
/v3/api/business/reseller/classes/{classId}/instances
Returns a class and all its upcoming scheduled instances.

Request

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

Responses

🟢200
*/*
Class with upcoming instances
Body*/*

🟠401
🟠403
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v3/api/business/reseller/classes/cls_abc123/instances' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Success
{
    "object": "class",
    "id": "cls_abc123",
    "name": "Morning Yoga Flow",
    "category": "YOGA",
    "instructor": "Chioma Adeyemi",
    "description": "A calming morning flow suitable for all levels",
    "provider_name": "FitHub Lagos",
    "address": "5 Adeola Odeku Street, Victoria Island, Lagos",
    "distance_km": 3.1,
    "schedule": "Mon, Wed, Fri at 07:00",
    "duration_minutes": 60,
    "price": 0,
    "currency": "NGN",
    "credit_cost": 3,
    "spots_total": 20,
    "spots_remaining": 8,
    "next_instance": 1746853200000,
    "upcoming_instances": [
        {
            "object": "class_instance",
            "id": "ci_abc123",
            "scheduled_for": 1746853200000,
            "spots_remaining": 8,
            "bookable": true
        },
        {
            "object": "class_instance",
            "id": "ci_def456",
            "scheduled_for": 1747026000000,
            "spots_remaining": 15,
            "bookable": true
        },
        {
            "object": "class_instance",
            "id": "ci_ghi789",
            "scheduled_for": 1747198800000,
            "spots_remaining": 0,
            "bookable": false
        }
    ],
    "created": 1746700000000,
    "message": "Class retrieved successfully"
}
Modified at 2026-05-21 13:30:24
Previous
Get classes
Next
Initiate a class booking
Built with