API v3 is live and in beta: expect possible malfunctions and breaking changes in the coming days. If you find a bug, please report it to your Sillage contact.
v2DeprecatedTop Account List

List Accounts

List the found accounts in a partner workspace's top account list, paginated.

Returns a paginated list of accounts in this workspace's top account list whose enrichment resolved a company record (status: found). Accounts that could not be matched are available at List not-found accounts.

List accounts

GET/api/v2/partner/workspaces/{partner_workspace_id}/top-account-list/accounts

Path parameters

ParameterTypeDescription
partner_workspace_idstringOpaque workspace identifier from the partner system.

Query parameters

ParameterTypeDefaultDescription
pageinteger1Page number. Must be greater than or equal to 1.
page_sizeinteger25Number of items per page. Must be between 1 and 100.

Example request

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

Example response

{
  "data": [
    {
      "company_id": "456",
      "company": {
        "name": "Acme",
        "domain": "acme.com",
        "linkedin_url": "https://www.linkedin.com/company/acme",
        "linkedin_handle": "acme",
        "logo_url": "https://cdn.getsillage.com/logos/acme.png",
        "status": "found"
      },
      "tier": "Tier 1",
      "imported_at": "2026-06-15T10:00:00Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "total": 1
    }
  }
}

Response fields

FieldTypeDescription
data[].company_idstringThe company's id in Sillage.
data[].companyobjectResolved company data after enrichment.
data[].company.statusstringAlways found for this endpoint.
data[].tierstring or nullThe account's tier. null when no tier has been set, otherwise one of Tier 1, Tier 2, Tier 3.
data[].imported_atstringISO 8601 timestamp of when this account was imported.
meta.paginationobjectPagination metadata.

Errors

StatusMeaning
401The master key is missing or invalid.
403The master key is not authorized to access this resource.
404No workspace found for this partner_workspace_id.
429Too many requests.
500An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json.

On this page