List referrer's campaigns

GET

/referrer-campaigns

Get a paginated list of all campaigns for the authenticated organization.
Supports pagination, sorting, filtering, and searching across campaign names and descriptions.
Only returns campaigns belonging to the authenticated referrer organization.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.perfectworks.io/api/v0/referrer-campaigns'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Items retrieved successfully",
    "data": [
        {
            "id": "1",
            "name": "Item 1"
        },
        {
            "id": "2",
            "name": "Item 2"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 10,
        "total": 25,
        "pages": 3,
        "hasNext": true,
        "hasPrev": false
    }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200OK

application/json

Campaigns retrieved successfully

Body

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Modified at 2025-08-22 18:48:44

Create referral campaign

Get campaign details