List referral links

Get all referral links for a partner

GET /v1/partners/{id}/referral_links

List referral links

cURL

curl --request GET \
  --url https://api.example.com/v1/partners/{id}/referral_links

200 OK

{
  "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
}

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

cURL

curl --location 'https://api.partnero.com/v1/partners/partner_123/referral_links' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response

200 OK

{
  "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
}

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