SEsellauth
Affiliates

List Affiliates

Changed on

Returns the shop's affiliates (customers with an affiliate code) with their stats.

get/v1/shops/{shopId}/affiliates

Request

Request body

pageinteger nullable

Page number.

perPageinteger nullable

Items per page, 1-100. Must be at least 1. Must not be greater than 100.

searchstring nullable

Search by email or affiliate code. Must not be greater than 100 characters.

tier_idinteger nullable

Filter by affiliate tier ID.

status'active' | 'suspended' | 'all' nullable

active (default), suspended, or all.

segment'active' | 'inactive' | 'new' nullable
orderColumn'id' | 'email' | 'affiliate_code' | 'affiliate_referrer_earnings' | 'balance' | 'affiliate_balance' | 'affiliate_code_set_at' | 'referrals_count' nullable
orderDirection'asc' | 'desc' nullable

Example request

{
  "page": 1
}

Response

current_pageinteger
first_page_urlstring
frominteger
last_pageinteger
last_page_urlstring
next_page_urlstring nullable
pathstring
per_pageinteger
prev_page_urlstring nullable
tointeger
totalinteger

Example response

{
  "current_page": 1,
  "data": [
    {
      "id": 1,
      "email": "customer@sellauth.test",
      "shop_id": 1,
      "balance": "100.00",
      "affiliate_balance": "0.00",
      "affiliate_code": "PARTNER10",
      "affiliate_code_set_at": "2026-11-01 20:00:51",
      "affiliate_tier_id": null,
      "affiliate_referrer_earnings": "0.00",
      "created_at": "2026-11-01T20:00:51.000000Z",
      "referrals_count": 0,
      "affiliate_tier": null
    }
  ],
  "first_page_url": "http://api.sellauth.test/v1/shops/1/affiliates?page=1",
  "from": 1,
  "last_page": 1,
  "last_page_url": "http://api.sellauth.test/v1/shops/1/affiliates?page=1",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "page": null,
      "active": false
    },
    {
      "url": "http://api.sellauth.test/v1/shops/1/affiliates?page=1",
      "label": "1",
      "page": 1,
      "active": true
    },
    {
      "url": null,
      "label": "Next »",
      "page": null,
      "active": false
    }
  ],
  "next_page_url": null,
  "path": "http://api.sellauth.test/v1/shops/1/affiliates",
  "per_page": 20,
  "prev_page_url": null,
  "to": 1,
  "total": 1
}

Changes

  • ff0d59c98d7aRevision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      added the optional property // to the response with the status