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

# List referred users

`GET /referrals`

## Request

- Base URL: `https://refgrow.com/api/v1`
- URL: `https://refgrow.com/api/v1/referrals`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer
- `affiliate_id` integer
- `status` string

## Response `200`

Paginated list

- object
  - `success` boolean
  - `pagination` object
    - `limit` integer
    - `offset` integer
    - `total` integer
    - `has_more` boolean
  - `data` Referral[]
    - `id` integer
    - `user_email` string, email
    - `affiliate_id` integer, nullable
    - `affiliate_code` string, nullable
    - `conversion_status` string
    - `conversion_date` string, date-time, nullable
    - `created_at` string, date-time

---

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