List Affiliates

This endpoint allows you to fetch a list of marketing affiliates.

Deprecation Notice

Starting November 01, 2025, this endpoint’s response will be updated, and the old response body will be deprecated.
To avoid breaking changes, update your integration to use the new schema, which supports the new Salla affiliate system.
If the Merchant is still using the old Salla affiliate system, the endpoint will still depend on deprecated payloads.
See the ChangeLog for more details.

Scopes

marketing.read- Marketing Read Only

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Responses

🟢200Default Response

application/json

Body

Example

{
    "status": 200,
    "success": true,
    "data": [
        {
            "id": 611208326,
            "title": "Affiliate Test",
            "type": "public",
            "apply_to": "first-second-order",
            "commission": {
                "type": "percent",
                "value": 50,
                "minimum_apply": 0
            },
            "discount": {
                "type": "percent",
                "value": 50
            },
            "scopes": [
                {
                    "id": 1234567,
                    "name": "salla-store",
                    "type": "store",
                    "link": "https://salla.sa/intend/1234567",
                    "operation": "include",
                    "thumbnail": "https://cdn.salla.sa/oEGE/03m2U2cnDGZck7WZNEDJgzMrrtH3MsBmMKXhoIV1.png"
                }
            ],
            "start_date": "",
            "end_date": "",
            "status": "active"
        }
    ],
    "pagination": {
        "count": 1,
        "total": 1,
        "perPage": 15,
        "currentPage": 1,
        "totalPages": 1,
        "links": []
    }
}

🟢200Deprecated Response

🟠401Unauthorized

Request

Request Code Samples

Responses