Customers

List customers

Six explicit statuses, refunded included. The envelope is the same flat { data, has_more, total_count } as every other list.

Scope: read

get/v1/customers

Request

  • Base URL: https://api.affiliaterail.com
  • URL: https://api.affiliaterail.com/v1/customers
  • Auth: HTTP bearer

Query parameters

program_idstring required

Required on every list

Example:prg_7uSyy9FqVLCFWrdPeZaK
limitstring

1 to 100, default 25

Example:25
starting_afterstring

Object id; returns the page after it (older)

ending_beforestring

Object id; returns the page before it (newer)

string
OR
string[]
string
OR
string[]
partner_idstring
status'lead' | 'trial' | 'active' | 'cancelled' | 'refunded' | 'suspended'
emailstring
external_customer_idstring

Response

Customers

has_moreboolean required

Pass the last object's id as starting_after to fetch the next page

total_countinteger required

Count of every object matching the filters, ignoring the cursor

Example response

{
  "data": [
    {
      "id": "cus_7uSyy9FqVLCFWrdPeZaK",
      "program_id": "prg_7uSyy9FqVLCFWrdPeZaK",
      "partner_id": "part_7uSyy9FqVLCFWrdPeZaK",
      "referral_id": "ref_7uSyy9FqVLCFWrdPeZaK",
      "link_id": "lnk_7uSyy9FqVLCFWrdPeZaK",
      "coupon_id": "cpn_7uSyy9FqVLCFWrdPeZaK",
      "lead_at": "2026-08-21T10:15:30.000Z",
      "converted_at": "2026-08-21T10:15:30.000Z",
      "created_at": "2026-08-21T10:15:30.000Z",
      "updated_at": "2026-08-21T10:15:30.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.