List Affiliates

Retrieve a paginated list of affiliates in your program.

GET/api/v1/affiliates

Returns a paginated list of affiliates (partnerships) for the product associated with your API key. Each affiliate includes basic profile information and all-time performance stats.

Query parameters

ParameterTypeDescription
status
stringFilter by status: active, pending, rejected, or removed. Returns all statuses if omitted.
cursor
stringPagination cursor from a previous response's next_cursor field.
limit
integerNumber of results to return (1–100). Defaults to 50.

Example request

bash
curl https://anderro.com/api/v1/affiliates?status=active&limit=10 \
  -H "x-api-key: sk_your_secret_key"

Responses

200Paginated list of affiliates
json
{
  "data": [
    {
      "id": "part_abc123",
      "status": "active",
      "referral_code": "jane-smith",
      "created_at": "2026-04-01T10:00:00.000Z",
      "affiliate": {
        "id": "ap_xyz789",
        "email": "[email protected]",
        "name": "Jane Smith"
      },
      "stats": {
        "clicks": 142,
        "conversions": 8,
        "earned_cents": 39200
      }
    }
  ],
  "pagination": {
    "next_cursor": "dGhpcyBpcyBhIGN1cnNvcg",
    "has_more": true
  }
}

Cursor-based pagination

Use the next_cursor value from the response as the cursor query parameter in your next request to fetch the next page. When has_more is false, you've reached the end of the list. See the Pagination guide for more details.