> ## Documentation Index
> Fetch the complete documentation index at: https://docs.partnero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List referral links

> Get all referral links for a partner

A referral link is a unique, trackable URL that partners share with their audience. It allows the system to attribute sign-ups and purchases to the partner.

## Endpoint

```
GET https://api.partnero.com/v1/partners/{id}/referral_links
```

## Path Parameters

| Parameter | Type   | Required | Description         |
| --------- | ------ | -------- | ------------------- |
| `id`      | string | Yes      | Partner's unique ID |

## Query Parameters

| Parameter | Type    | Default | Description                        |
| --------- | ------- | ------- | ---------------------------------- |
| `limit`   | integer | 15      | Number of results per page (1-250) |
| `page`    | integer | 1       | Page number for pagination         |

## Request

```bash cURL theme={null}
curl --location 'https://api.partnero.com/v1/partners/partner_123/referral_links' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "ref_123",
        "key": "ref_123",
        "url": "https://partnero.com?aff=ref_123",
        "default": true,
        "is_additional": false,
        "direct_tracking": false,
        "direct_tracking_redirect": false,
        "direct_tracking_redirect_url": null
      },
      {
        "id": "ref_456",
        "key": "ref_456",
        "url": "https://partnero.com?aff=ref_456",
        "default": false,
        "is_additional": false,
        "direct_tracking": false,
        "direct_tracking_redirect": false,
        "direct_tracking_redirect_url": null
      }
    ],
    "status": 1
  }
  ```
</ResponseExample>

### Response Fields

| Field                    | Type    | Description                               |
| ------------------------ | ------- | ----------------------------------------- |
| `data[].id`              | string  | Link identifier                           |
| `data[].key`             | string  | Referral key used in URL                  |
| `data[].url`             | string  | Full referral URL                         |
| `data[].default`         | boolean | Whether this is the default link          |
| `data[].is_additional`   | boolean | Whether this is an additional domain link |
| `data[].direct_tracking` | boolean | Direct tracking enabled                   |