Siren

List Collaborators

Retrieve a paginated list of collaborators with filtering, search, and field selection.

Last updated: April 9, 2026

List Collaborators

GET /siren/v1/collaborators

Returns a paginated list of collaborators. Results are wrapped by the ListResponseWrapperInterceptor.

Query Parameters:

ParameterTypeDefaultDescription
fieldsstring—Comma-separated list of fields to include (required)
statusstring—Filter by exact status
fullNamestring—Filter by exact full name
nicknamestring—Filter by exact nickname
emailstring—Filter by exact email
sstring—Search across fullName, nickname, email, and alias codes
programIdinteger—Filter to collaborators enrolled in this program
distributorIdinteger—Filter to collaborators assigned to this distributor
numberinteger10Results per page
offsetinteger0Pagination offset
orderBystringidSort field
orderstringASCSort direction: ASC or DESC

Response Headers:

  • x-siren-estimated-count. Total matching records (exposed via Access-Control-Expose-Headers).

Example Request:

GET /siren/v1/collaborators?fields=id,fullName,status,referralCode&status=active&number=25

Example Response:

[
  {
    "id": 7,
    "fullName": "Jane Smith",
    "status": "active",
    "referralCode": "BCDGHJK"
  }
]