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

Get Top Account List

Read the full enriched top account list for a partner workspace.

Returns the enriched accounts currently stored in the top account list for this workspace. Includes both accounts whose enrichment resolved a company record and accounts that could not be matched. This is not paginated. For large lists, prefer List accounts and List not-found accounts.

Get top account list

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

Path parameters

ParameterTypeDescription
partner_workspace_idstringOpaque workspace identifier from the partner system.

Example request

curl "https://api.getsillage.com/api/v2/partner/workspaces/ws_123/top-account-list" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Example response

{
  "data": {
    "accounts": [
      {
        "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"
      },
      {
        "company": {
          "status": "not_found"
        },
        "imported_at": "2026-06-15T10:00:00Z"
      }
    ]
  }
}

Response fields

FieldTypeDescription
data.accountsarrayEnriched account objects stored in the top account list.
data.accounts[].company_idstringThe company's id in Sillage. Only present when company.status is found.
data.accounts[].companyobjectResolved company data after enrichment.
data.accounts[].company.statusstringfound if a company record was resolved, not_found otherwise.
data.accounts[].tierstring or nullThe account's tier. null when no tier has been set, otherwise one of Tier 1, Tier 2, Tier 3.
data.accounts[].imported_atstringISO 8601 timestamp of when this account was imported.

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