Get Bulk Sync Status | Polytomic Docs

curl https://app.polytomic.com/api/bulk/syncs/248df4b7-aa70-47b8-a036-33ac447e668d/status \
     -H "X-Polytomic-Version: X-Polytomic-Version" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "data": {
    "current_execution": {
      "completed_at": "2024-06-10T14:45:00Z",
      "created_at": "2024-06-10T13:00:00Z",
      "error_count": 2,
      "fetch_mode": "incremental",
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "is_partial": false,
      "is_resync": true,
      "is_test": false,
      "output_disposition": "rebuild",
      "record_count": 1250,
      "schemas": [
        {
          "completed_at": "2024-06-10T14:40:00Z",
          "created_at": "2024-06-10T13:05:00Z",
          "error_count": 1,
          "output_name": "account",
          "record_count": 800,
          "schema": "account",
          "started_at": "2024-06-10T13:10:00Z",
          "status": "running",
          "status_message": "Processing account records",
          "updated_at": "2024-06-10T14:40:00Z",
          "warning_count": 1
        },
        {
          "created_at": "2024-06-10T13:05:00Z",
          "error_count": 1,
          "output_name": "contact",
          "record_count": 450,
          "schema": "contact",
          "started_at": "2024-06-10T13:15:00Z",
          "status": "running",
          "status_message": "Fetching contact data",
          "updated_at": "2024-06-10T14:40:00Z",
          "warning_count": 0
        }
      ],
      "started_at": "2024-06-10T13:00:00Z",
      "status": "running",
      "status_message": "Bulk sync is currently running",
      "type": "scheduled",
      "updated_at": "2024-06-10T14:45:00Z",
      "warning_count": 1
    },
    "ingestion_status": {
      "enabled": true,
      "highwater_mark": "2024-06-10T14:30:00Z",
      "is_running": true,
      "position": "offset_12345",
      "position_time": "2024-06-10T14:30:00Z",
      "status": "ok",
      "status_message": "CDC ingestion operating normally",
      "updated_at": "2024-06-10T14:45:00Z"
    },
    "last_execution": {
      "completed_at": "2024-06-09T12:00:00Z",
      "created_at": "2024-06-09T10:00:00Z",
      "error_count": 0,
      "fetch_mode": "full",
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "is_partial": false,
      "is_resync": false,
      "is_test": false,
      "output_disposition": "truncate",
      "record_count": 1500,
      "schemas": [
        {
          "completed_at": "2024-06-09T11:50:00Z",
          "created_at": "2024-06-09T10:05:00Z",
          "error_count": 0,
          "output_name": "contact",
          "record_count": 1500,
          "schema": "contact",
          "started_at": "2024-06-09T10:10:00Z",
          "status": "completed",
          "status_message": "Completed successfully",
          "updated_at": "2024-06-09T11:50:00Z",
          "warning_count": 0
        }
      ],
      "started_at": "2024-06-09T10:00:00Z",
      "status": "completed",
      "status_message": "Last sync completed without errors",
      "type": "scheduled",
      "updated_at": "2024-06-09T12:00:00Z",
      "warning_count": 0
    },
    "next_execution_time": "2024-06-11T13:00:00Z"
  }
}

Returns the current status of a bulk sync.

The response includes the sync’s current active/inactive state together with information about the most recent execution — its status, start time, and any errors — making this endpoint well-suited for health checks and monitoring dashboards.

For the complete execution history, use GET /api/bulk/syncs/{id}/executions. For the full details of a specific run, including per-schema breakdowns, use GET /api/bulk/syncs/{id}/executions/{exec_id}.

Returns the current status of a bulk sync. The response includes the sync's current active/inactive state together with information about the most recent execution — its status, start time, and any errors — making this endpoint well-suited for health checks and monitoring dashboards. For the complete execution history, use [`GET /api/bulk/syncs/{id}/executions`](../../../../../api-reference/bulk-sync/executions/list). For the full details of a specific run, including per-schema breakdowns, use [`GET /api/bulk/syncs/{id}/executions/{exec_id}`](../../../../../api-reference/bulk-sync/executions/get).

Authentication

AuthorizationBearer

Bearer user API key

AuthorizationBasic

Basic organization-scoped API key

Path parameters

idstringRequiredformat: "uuid"

Unique identifier of the bulk sync.

Response

dataobject

Errors

404

Not Found Error

500

Internal Server Error

Authentication

Path parameters

Headers

Response

Errors