Affilibee
Toggle sidebar

List affiliates

API reference for retrieving a paginated list of affiliates for the authenticated merchant.

Endpoint

GET
/api/v2/affiliates

Authorization

Learn more
Authorization
string
header
required

The Bearer token generated in the Affilibee dashboard.

Body

application/json

per_page
integer

The number of affiliates to return per page. Default is 15.

page
integer

The page number to retrieve.

tier_slug
string

Filter affiliates by their assigned tier slug.

Example requests

curl -X GET "https://affilibee.com/api/v2/affiliates?per_page=15&page=1" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Accept: application/json"
const token = "YOUR_ACCESS_TOKEN";
const url = "https://affilibee.com/api/v2/affiliates?per_page=15&page=1";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Accept": "application/json"
  }
});

const data = await response.json();
console.log(data);
import requests

token = "YOUR_ACCESS_TOKEN"
url = "https://affilibee.com/api/v2/affiliates"
params = {
    "per_page": 15,
    "page": 1,
}

response = requests.get(
    url,
    headers={
        "Authorization": f"Bearer {token}",
        "Accept": "application/json",
    },
    params=params,
)

print(response.json())
<?php

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$token = 'YOUR_ACCESS_TOKEN';

$client = new Client([
    'base_uri' => 'https://affilibee.com/api/v2',
    'headers' => [
        'Authorization' => "Bearer $token",
        'Accept' => 'application/json',
    ],
]);

$response = $client->get('affiliates', [
    'query' => [
        'per_page' => 15,
        'page' => 1,
    ],
]);

echo $response->getBody();

Responses

application/json

200
Success

Returned when the list of affiliates is successfully retrieved.

401
Unauthorized

Returned when the request does not include a valid Bearer token.

Response examples

{
    "success": true,
    "data": {
        "affiliates": [
            {
                "name": "John Doe",
                "slug": "john-doe",
                "status": "active",
                "tier": {
                    "name": "Standard",
                    "slug": "standard"
                },
                "accepted_at": "2026-03-21T23:29:00Z",
                "created_at": "2026-03-20T10:00:00Z"
            }
        ]
    },
    "errors": null,
    "meta": {
        "pagination": {
            "current_page": 1,
            "last_page": 5,
            "per_page": 15,
            "total": 75,
            "next_page_url": "https://api.mellifera.test/api/v2/affiliates?page=2",
            "prev_page_url": null
        },
        "trace_id": "20260321:api:abc12"
    }
}
{
    "success": false,
    "data": null,
    "errors": {
        "message": [
            "Unauthenticated."
        ]
    },
    "meta": {
        "trace_id": "20260321:api:abc12"
    }
}

Notes

  • The response is paginated and includes metadata about the pagination state.

  • Only affiliates associated with your merchant account are returned.

Got questions? We're here for you.

We help teams run affiliate programs through API-first integrations that fit the platform they already use.

© 2025 Affilibee Handelsbolag (969802-2481)

Integrations

API Integration
How can we assist you today?

Fill in the form below and we'll get back to you as soon as possible.

Name
Email
Message