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
fieldsstringComma-separated list of fields to include (required)
statusstringFilter by exact status
fullNamestringFilter by exact full name
nicknamestringFilter by exact nickname
emailstringFilter by exact email
sstringSearch across fullName, nickname, email, and alias codes
programIdintegerFilter to collaborators enrolled in this program
distributorIdintegerFilter 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"
  }
]