Get List

Returns a single list by its numeric id, scoped to your workspace. Returns 404 when the list does not exist in your workspace.

Get list

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

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
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/lists/company/128" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Example response

{
  "data": {
    "id": 128,
    "kind": "company",
    "type": "competitor",
    "name": "Key competitors",
    "description": "Companies we track for competitive signals",
    "member_count": 12,
    "bound_agent_count": 1,
    "tier": null,
    "default_tracking_status": "followed",
    "default_signal_bucket": null
  }
}

Errors

Status	Description
401	The API key is missing or invalid.
404	The list does not exist in your workspace.
422	Invalid `list_id` — must be a positive integer.
429	Too many requests.