> For the complete documentation index, see [llms.txt](https://docs.sparkloop.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sparkloop.app/api-v2-deprecated/endpoints/subscribers-2/referrals.md).

# Referrals

## Get partner program referrals

<mark style="color:blue;">`GET`</mark> `https://api.sparkloop.app/v2/partner_programs/:identifier/referrals`

Partner program referrals are ordered in descending order by *referred\_at.*

#### Path Parameters

| Name                                         | Type   | Description            |
| -------------------------------------------- | ------ | ---------------------- |
| identifier<mark style="color:red;">\*</mark> | string | Partner program's UUID |

#### Query Parameters

| Name             | Type              | Description                                                    |
| ---------------- | ----------------- | -------------------------------------------------------------- |
| referred\_after  | Date (YYYY-MM-DD) | Only return referrals with referred\_at on or after this date  |
| referred\_before | Date (YYYY-MM-DD) | Only return referrals with referred\_at on or before this date |

{% tabs %}
{% tab title="200" %}

```json
{
  "referrals": [
    <Partner Program Referral Object>,
    <Partner Program Referral Object>,
    <Partner Program Referral Object>
  ],
  "meta": {
    "per_page": 50,
    "page": 1,
    "total_pages": 12,
    "total_referrals": 598
  }
}
```

{% endtab %}
{% endtabs %}