1. Lookup
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
      GET
    • Initiate a lookup
      POST
    • Verify a lookup
      POST
    • Get a client
      GET
    • Get client credits
      GET
  • 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. Lookup

Introduction

The Lookup section covers the third-party lookup flow for clients managed by another reseller. Use it to discover approved issuers, initiate a lookup for a client, and verify that lookup with the access code the client shares back.

What you can do#

List approved issuers available for cross-party lookup
Initiate a third-party lookup against another reseller's client
Verify a pending lookup with the client's access code
Receive a lookup token that your business stores and reuses later when generating access codes
Get a client's record
Get a client's credit balance and recent credit transaction history

Key concepts#

Lookup flow
The flow is:
1.
Call GET /issuers to find the reseller that owns the client.
2.
Call POST /lookups with that issuer and the client ID.
3.
Collect the access code the client receives from the issuer.
4.
Call POST /lookups/{id}/verify with that access code.
5.
Store the returned lookup token on your own system and reuse it in Bardge-Lookup-Token when calling POST /access-codes.
There is no endpoint for retrieving lookup tokens later. The token is returned at verification time and must be persisted by your business for future use until it expires.
Client identity
Clients are identified by a client_id - a stable identifier assigned by the issuer reseller. Supply this ID when initiating a lookup against that issuer.
Issuers
An issuer is a reseller that has enabled third-party lookup on their account. When you need access to a client managed by a different reseller, supply that issuer's id when initiating the lookup. Use GET /issuers to retrieve the list of resellers currently approved for cross-party lookup.
When to use Lookup
Lookup endpoints are designed for these common scenarios:
ScenarioEndpoint to use
Cross-party setup - discover which resellers support third-party lookupGET /issuers
Start access delegation for a client managed by another resellerPOST /lookups
Confirm the client approved the lookup by sharing their access codePOST /lookups/{id}/verify
Generate future access codes for that looked-up client after verificationPOST /access-codes with Bardge-Lookup-Token
Lookup token lifecycle
The lookup token returned by verification remains valid until the client's pass expires. Bardge does not provide a lookup-token listing or retrieval endpoint, so your business must store the token when it is issued.

Related sections#

Access Codes - use the stored lookup token to generate client check-in codes later
Bookings - use the stored lookup token to book class appointments and spa services later
Passes - a valid active pass must exist for the issuer's client before lookup verification can succeed
Modified at 2026-05-19 13:57:57
Previous
Get credit packages
Next
Get issuers
Built with