1. Access Codes
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. Access Codes

Introduction

An access code is a short-lived token that a client presents at a provider's front desk to verify their pass and check in. It encodes the client's identity and pass validity into a scannable QR code, letting the provider confirm the visit without requiring the client to show credentials.

What you can do#

Generate an access code for a client visit

Key concepts#

When to generate a code
Generate an access code at the point the client is ready to check in - typically when they arrive at the venue or shortly before. Access codes are not tied to bookings; they represent a general pass-based visit. For appointment-based visits (spa bookings), the booking itself serves as the check-in record - you may still generate a code as a convenience for front-desk scanning.
For third-party lookup flows, first verify the lookup and persist the returned lookup token on your own system. When you need another access code later, pass that stored token in the Bardge-Lookup-Token header. Bardge does not expose a list endpoint for recovering previously issued lookup tokens.
Expiry
Access codes expire at the end of the day they are generated. The exact expiry timestamp is returned in the expires_at field of the response. Do not generate codes far in advance - generate them on demand when the client is at or near the venue.
One code per visit
Generate one access code per visit. Reusing a code across multiple visits or generating multiple codes for the same visit window will result in check-in rejections at the provider's scanner.
Code format
The API returns the access code as both a raw token string (access_code) and a QR-ready data URI (qr_code). Render the QR data URI directly in your client-facing UI - no additional encoding is required.

Related sections#

Passes - a valid active pass is required before an access code can be generated
Bookings - for appointment-based visits, create a booking first; the access code supplements the booking for front-desk check-in
Modified at 2026-05-19 12:41:08
Previous
Get providers for a pass
Next
Generate dynamic access code
Built with