# List the referred billers

This endpoint should be used for tracking referrals from the moment a user registered under a referral link or code that belongs to the caller. The caller is identified from the authentication token provided.

Endpoint: GET /referrals/billers
Version: 1.0.0
Security: Biller Access Token (Staging), Platform Bearer Token, Biller Access Token (Production)

## Query parameters:

  - `referralCode` (string)
    Return only referrals for this referral link or code.

  - `lastUpdatedTime` (string)
    Return only referrals updated at or after this time.

## Response 200 fields (application/json):

  - `referredBillers` (array)
    The referred billers matching the request, oldest referral first.

  - `referredBillers.referralId` (string, required)
    Stable identifier of this referral. It is the same on every read and there is exactly one per referral, so it can be stored as the join key linking the referral to the caller's own records.

  - `referredBillers.referralCode` (string, required)
    The referral link or code the onboarding biller registered with.

  - `referredBillers.codeType` (string, required)
    Whether referralCode is a link or a standalone code.
    Enum: "LINK", "CODE"

  - `referredBillers.contactPointDomain` (string, required)
    The domain of the user's contact point, for example the domain of their email address.

  - `referredBillers.status` (string, required)
    How far the referral has progressed.
    Enum: "USER_REGISTERED", "BILLER_REGISTERED", "FIRST_PAYMENT_MADE"

  - `referredBillers.creationTime` (string, required)
    When the referral was first tracked.

  - `referredBillers.lastUpdatedTime` (string, required)
    When the referral was last updated.