List Members

Returns a paginated list of a list's members, each with its own tracking status and signal bucket (null when it follows the list default). The shape of each member follows the list kind: company lists return name; people lists return first_name / last_name. The total is in meta.pagination.

List members

GET/api/v2/partner/workspaces/{partner_workspace_id}/lists/{kind}/{list_id}/members

Path parameters

Parameter	Type	Description
partner_workspace_id	string	Opaque workspace identifier from the partner system.
kind	string	List kind: `company` or `profile` (matches the list type).
list_id	integer	Identifier of the list.

Query parameters

Parameter	Type	Description
page	integer	Page number, starting at 1. Defaults to 1.
page_size	integer	Items per page. Defaults to 25, max 100.
q	string	Search term. Matches by name, LinkedIn handle, or (for people) current company. Case-insensitive, matches partial text, up to 255 characters.
response_format	enum	`concise`, `normalized` (default), or `detailed`.

Example request

curl "https://api.getsillage.com/api/v2/partner/workspaces/ws_123/lists/company/128/members?page=1&page_size=25&q=openai" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Example response

{
  "data": [
    {
      "id": 901,
      "name": "OpenAI",
      "linkedin_handle": "openai",
      "linkedin_url": "https://www.linkedin.com/company/openai",
      "tracking_status": null,
      "signal_bucket": null
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "total": 12
    }
  }
}

Errors

Status	Description
401	The API key is missing or invalid.
404	The list does not exist in your workspace.
422	Invalid `list_id` or query parameters.
429	Too many requests.