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 Status

Poll the ingestion status of a partner workspace's top account list.

Returns the current state of the latest top account list ingestion for this workspace. Use this to poll after Add accounts, which runs asynchronously and responds with 202 Accepted before the accounts are fully processed.

Get status

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

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

Example response

{
  "state": "processing",
  "total_accounts": 42
}

Response fields

FieldTypeDescription
statestringqueued, processing, completed, or failed. queued also means no ingestion has run yet.
total_accountsintegerNumber of accounts currently stored in the top account list.

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