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

    Authentication

    The Bardge Reseller API authenticates using API keys passed as Bearer tokens.

    How to authenticate#

    Include your API key in the Authorization header on every request:
    Authorization: Bearer <your-api-key>
    Your API key is tied to your reseller account. Keep it secret — treat it like a password. Do not expose it in client-side code or public repositories.

    Finding your API key#

    Your API key is available in the Bardge Reseller Dashboard:
    1.
    Log in to the Bardge Reseller Dashboard
    2.
    Click Settings in the left sidebar
    3.
    Click API Credentials
    Your active API key is displayed on this page. You can also rotate your key from here.

    How keys work#

    API keys are encrypted tokens. When you send a request, the API:
    1.
    Extracts the Bearer token from the Authorization header
    2.
    Decrypts and validates the key against your reseller account
    3.
    Checks that your account is active and enabled
    All of this happens transparently — you simply pass the key as issued.

    Error responses#

    If your API key is missing or invalid, the API returns:
    {
      "error": {
        "type": "authentication_error",
        "code": "invalid_api_key",
        "message": "Invalid API key provided",
        "request_id": "req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
      }
    }
    If your reseller account has been disabled:
    {
      "error": {
        "type": "permission_error",
        "code": "account_disabled",
        "message": "Reseller account is not enabled",
        "request_id": "req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
      }
    }

    Key rotation#

    You can rotate your API key at any time from the Bardge Reseller Dashboard:
    1.
    Log in to the Bardge Reseller Dashboard
    2.
    Click Settings in the left sidebar
    3.
    Click API Credentials
    4.
    Click Reset secret API keys
    Your old key is invalidated immediately upon rotation. Update all integrations with the new key before rotating to avoid downtime.
    Modified at 2026-05-07 11:57:55
    Previous
    Introduction
    Next
    Errors
    Built with