---
title: "List the referred billers"
method: GET
path: "/referrals/billers"
tags: ["Referrals"]
---

# List the referred billers

`GET /referrals/billers`

## Request

- Base URL: `https://api.adfin.com/api`
- URL: `https://api.adfin.com/api/referrals/billers`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.staging.adfin.com/api/oauth2/token`
  - HTTP bearer
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.adfin.com/api/oauth2/token`

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.

## Query parameters

- `referralCode` string: Return only referrals for this referral link or code.
- `lastUpdatedTime` string, date-time: Return only referrals updated at or after this time.

## Response `200`

OK

- ReferredBillersResponse: The billers referred by the calling entity.
  - `referredBillers` ReferredBillerResponse[]: The referred billers matching the request, oldest referral first.
    - `referralId` string, uuid, 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.
    - `referralCode` string, required: The referral link or code the onboarding biller registered with.
    - `codeType` 'LINK' | 'CODE', required: Whether referralCode is a link or a standalone code.
    - `contactPointDomain` string, required: The domain of the user's contact point, for example the domain of their email address.
    - `status` 'USER_REGISTERED' | 'BILLER_REGISTERED' | 'FIRST_PAYMENT_MADE', required: How far the referral has progressed.
    - `creationTime` string, date-time, required: When the referral was first tracked.
    - `lastUpdatedTime` string, date-time, required: When the referral was last updated.

## Changes

- **2026-09-11** `d034b7b4c205`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adfin/apis/adfin-api/changes/referrals/billers/get.md)

---

[API](https://skmtc.dev/adfin/apis/adfin-api.md) - [All operations](https://skmtc.dev/adfin/apis/adfin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adfin/apis/adfin-api/revisions/3bcc12f59ff0?raw)