Skip to main content
GET
/
v1
/
partners
/
{id}
/
referral_links
List referral links
curl --request GET \
  --url https://api.example.com/v1/partners/{id}/referral_links
{
  "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

ParameterTypeRequiredDescription
idstringYesPartner’s unique ID

​
Query Parameters

ParameterTypeDefaultDescription
limitinteger15Number of results per page (1-250)
pageinteger1Page 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

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

FieldTypeDescription
data[].idstringLink identifier
data[].keystringReferral key used in URL
data[].urlstringFull referral URL
data[].defaultbooleanWhether this is the default link
data[].is_additionalbooleanWhether this is an additional domain link
data[].direct_trackingbooleanDirect tracking enabled