List Watchlists

Returns a paginated list of the watchlists in your workspace, most recent first. Optionally filter by type or by business unit (persona_id). The total is in meta.pagination.

List watchlists

GET/api/v2/partner/workspaces/{partner_workspace_id}/watchlists

Path parameters

Parameter	Type	Description
partner_workspace_id	string	Opaque workspace identifier from the partner system.

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.
type	enum	Optional filter — one of `competitor`, `partner`, `customer`, `influencer`, `champion`.
persona_id	integer	Optional. Only return the lists attached to this business unit, plus the lists not attached to any business unit. An unknown `persona_id` returns `422`.
response_format	enum	`concise`, `normalized` (default), or `detailed`. `concise` omits `description` and counts.

Example request

curl "https://api.getsillage.com/api/v2/partner/workspaces/ws_123/watchlists?page=1&page_size=25" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Example response

{
  "data": [
    {
      "id": 128,
      "kind": "company",
      "type": "competitor",
      "title": "Key competitors",
      "description": "Companies we track for competitive signals",
      "entity_count": 12,
      "bound_agent_count": 1
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "total": 1
    }
  }
}

Errors

Status	Description
401	The API key is missing or invalid.
422	Invalid query parameters.
429	Too many requests.