---
title: "List Bulk Sync Execution Status"
method: GET
path: "/api/bulk/syncs/status"
tags: ["Bulk Sync"]
---

# List Bulk Sync Execution Status

`GET /api/bulk/syncs/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.

## Query parameters

- `all` boolean — When true, return status for every sync in the caller's organization. Overrides any sync_id values.
- `active` boolean — When true, return status only for active syncs in the caller's organization. Overrides any sync_id values.
- `sync_id` string[] — Return status for the specified bulk sync. Repeat the parameter to target multiple syncs. Ignored if all or active is true.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- ListBulkSyncExecutionsStatusEnvelope
  - `data` BulkSyncExecutionStatus[], nullable
    - `nextExecutionTime` string, date-time, nullable — Next scheduled execution time, if the sync has a schedule configured.
    - `schemas` BulkSyncSchemaExecutionStatus[], nullable — Most recent execution status for each enabled schema in the sync.
      - `completed_at` string, date-time, nullable — Timestamp when the most recent execution finished. Null while the execution is still running.
      - `error_count` integer — Number of errors emitted during the most recent execution.
      - `execution_id` string, uuid — ID of the most recent execution for the schema.
      - `record_count` integer — Number of records processed in the most recent execution.
      - `schema` string — Schema (table or object) identifier.
      - `started_at` string, date-time, nullable — Timestamp when the most recent execution started.
      - `status` 'created' | 'scheduled' | 'running' | 'exporting' | 'canceled' | 'completed' | 'failed' | 'interrupted' | 'processing'
      - `status_message` string — Human-readable detail for the current status (e.g. an error message when status is failed).
      - `warning_count` integer — Number of warnings emitted during the most recent execution.
    - `status` 'created' | 'scheduled' | 'running' | 'exporting' | 'canceling' | 'canceled' | 'completed' | 'failed' | 'processing' | 'errors' | 'interrupted'
    - `sync_id` string, uuid — Unique identifier of the bulk sync.

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/versions/b509e00e80aa/schema)