POpolytomic
Bulk Sync

Get Bulk Sync Status

Changed on

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}.

get/api/bulk/syncs/{id}/status

Request

  • Base URL
    https://app.polytomic.com
  • Auth
    • HTTP bearer
    • or HTTP basic

Path parameters

idstring uuid required

Unique identifier of the bulk sync

Example:248df4b7-aa70-47b8-a036-33ac447e668d

Headers

X-Polytomic-Versionstring

Response

OK

Example response

{
  "data": {
    "current_execution": {
      "completed_at": "2023-04-25T12:00:00Z",
      "created_at": "2023-04-25T12:00:00Z",
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "record_count": 1000,
      "schemas": [
        {
          "completed_at": "2023-04-25T12:00:00Z",
          "created_at": "2023-04-25T12:00:00Z",
          "output_name": "contact",
          "record_count": 1000,
          "schema": "contact",
          "started_at": "2023-04-25T12:00:00Z",
          "updated_at": "2023-04-25T12:00:00Z",
          "version": "rel2026.08.05.06~1a2b3c4"
        }
      ],
      "started_at": "2023-04-25T12:00:00Z",
      "type": "scheduled",
      "updated_at": "2023-04-25T12:00:00Z",
      "version": "rel2026.08.05.06~1a2b3c4"
    },
    "last_execution": {
      "completed_at": "2023-04-25T12:00:00Z",
      "created_at": "2023-04-25T12:00:00Z",
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "record_count": 1000,
      "schemas": [
        {
          "completed_at": "2023-04-25T12:00:00Z",
          "created_at": "2023-04-25T12:00:00Z",
          "output_name": "contact",
          "record_count": 1000,
          "schema": "contact",
          "started_at": "2023-04-25T12:00:00Z",
          "updated_at": "2023-04-25T12:00:00Z",
          "version": "rel2026.08.05.06~1a2b3c4"
        }
      ],
      "started_at": "2023-04-25T12:00:00Z",
      "type": "scheduled",
      "updated_at": "2023-04-25T12:00:00Z",
      "version": "rel2026.08.05.06~1a2b3c4"
    },
    "next_execution_time": "2023-04-25T12:00:00Z"
  }
}

Changes

  • 61c2b96f65baRevision changes
    • breaking

      the response's property type changed from object to no type for status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      added to the response property allOf list for the response status

  • a4c3b8f8eff7Revision changes
    • warning

      added the new completed_with_cancellations enum value to the // response property for the response status

    • warning

      added the new completed_with_cancellations enum value to the // response property for the response status