API ReferenceBulk SyncExecutions

List Bulk Sync Execution Status

Returns a concise per-schema status for one or more bulk syncs. This endpoint is a summary view, not an execution-history view. Each schema is represented at most once with its most recent execution status, and running executions are preferred over older terminal ones. Use this endpoint when you want a dashboard-style answer to "what is each sync doing now?" If you need the full execution history or a single execution's details, use [`GET /api/bulk/syncs/{id}/executions`](../../../../api-reference/bulk-sync/executions/list) or [`GET /api/bulk/syncs/{id}/executions/{exec_id}`](../../../../api-reference/bulk-sync/executions/get) instead. Setting `all=true` or `active=true` ignores any explicit `sync_id` filters and expands the request to the caller's organization scope.

Authentication

AuthorizationBasic

This is the Polytomic deployment key (on-premises only)

OR
AuthorizationBearer
This is the Polytomic API key

Headers

X-Polytomic-VersionstringRequired

Query parameters

allbooleanOptional

When true, return status for every sync in the caller’s organization. Overrides any sync_id values.

activebooleanOptional

When true, return status only for active syncs in the caller’s organization. Overrides any sync_id values.

sync_idlist of stringsOptional
Return status for the specified bulk sync. Repeat the parameter to target multiple syncs. Ignored if all or active is true.

Response

OK
datalist of objects or null

Errors

401
Unauthorized Error
404
Not Found Error