List Watchlists
Paginate the watchlists in your workspace.
Returns a paginated list of the watchlists in your workspace, most recent first. Optionally filter by type. The total is in meta.pagination.
List watchlists
GET/api/v2/watchlists
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. |
| response_format | enum | concise, normalized (default), or detailed. concise omits description and counts. |
Example request
curl "https://api.getsillage.com/api/v2/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. |