Affilibee
Toggle sidebar

List segments

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

Endpoint

GET
/api/v2/segments

Authorization

Learn more
Authorization
string
header
required

The Bearer token generated in the Affilibee dashboard.

Body

application/json

per_page
integer

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

page
integer

The page number to retrieve.

Example requests

curl -X GET "https://affilibee.com/api/v2/segments?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/segments?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/segments"
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('segments', [
    'query' => [
        'per_page' => 15,
        'page' => 1,
    ],
]);

echo $response->getBody();
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        using var client = new HttpClient();
        var url = "https://affilibee.com/api/v2/segments?per_page=15&page=1";
        var token = "YOUR_ACCESS_TOKEN";

        client.DefaultRequestHeaders.Add("Authorization", $"Bearer {token}");
        client.DefaultRequestHeaders.Add("Accept", "application/json");

        var response = await client.GetAsync(url);
        var content = await response.Content.ReadAsStringAsync();

        Console.WriteLine(content);
    }
}

Responses

application/json

200
Success

Returned when the list of segments is successfully retrieved.

401
Unauthorized

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

Response examples

{
    "success": true,
    "data": {
        "segments": [
            {
                "uuid": "98a7b6c5-d4e3-f2g1-h0i9-j8k7l6m5n4o3",
                "name": "Default",
                "description": "Default segment for all products.",
                "type": {
                    "name": "Percentage",
                    "slug": "percentage"
                },
                "slugs": ["default"],
                "skus": [],
                "created_at": "2026-03-20T10:00:00Z",
                "updated_at": "2026-03-20T10:00:00Z"
            }
        ]
    },
    "errors": null,
    "meta": {
        "pagination": {
            "current_page": 1,
            "last_page": 1,
            "per_page": 15,
            "total": 1,
            "next_page_url": null,
            "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 segments 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