---
title: "Get Sync"
method: GET
path: "/api/syncs/{id}"
tags: ["Model Sync"]
---

# Get Sync

`GET /api/syncs/{id}`

Returns a single model sync by ID.

To check whether a sync is currently running or has recently completed, use
[`GET /api/syncs/{id}/status`](../../../api-reference/model-sync/get-status). For the full history of
executions, use [`GET /api/syncs/{id}/executions`](../../../api-reference/model-sync/executions/list).

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- SyncResponseEnvelope
  - `data` SyncResponse
    - `active` boolean
    - `created_at` string, date-time
    - `created_by` OutputActor
      - `id` string, uuid
      - `name` string
      - `type` string
    - `encryption_passphrase` string
    - `fields` SyncField[]
      - `encryption_enabled` boolean — Whether the field should be encrypted.
      - `new` boolean — New is set to true if the target field should be created by Polytomic. This is not supported by all backends.
      - `override_value` string — Value to set in the target field; a mapping with an override value and no source is stored as an override field.
      - `source` Source
        - `field` string, required
        - `model_id` string, uuid, required
      - `sync_mode` string — Sync mode for the field; defaults to 'updateOrCreate'. If set to 'create', the field will not be synced if it already has a value. This is not supported by all backends.
      - `target` string, required — Target field ID the source field value will be written to.
    - `filter_logic` string
    - `filters` Filter[]
      - `field` Source
        - `field` string, required
        - `model_id` string, uuid, required
      - `field_id` string — Model or Target field name to filter on.
      - `field_type` 'Model' | 'Target'
      - `function` 'Equality' | 'Inequality' | 'IsNull' | 'IsNotNull' | 'True' | 'False' | 'OnOrAfter' | 'OnOrBefore' | 'GreaterThan' | 'GreaterThanEqual' | 'LessThan' | 'LessThanEqual' | 'StringContains' | 'StringStartsWith' | 'StringEndsWith' | 'StringDoesNotContain' | 'StringDoesNotStartWith' | 'StringDoesNotEndWith' | 'StringOneOf' | 'StringNotOneOf' | 'Between' | 'ArrayContains' | 'ArrayDoesNotContain' | 'InTheLast' | 'RelativeOnOrBefore' | 'RelativeOnOrAfter' | 'StringLike' | 'StringNotLike' | 'StringMatchesTrimmed', required
      - `label` string
      - `value` string
    - `id` string, uuid
    - `identity` Identity
      - `function` 'Equality' | 'ISubstring' | 'OneOf' | 'DomainMatch' | 'HostnameMatch', required
      - `new_field` boolean
      - `remote_field_type_id` string, nullable
      - `source` Source, required
        - `field` string, required
        - `model_id` string, uuid, required
      - `target` string, required
    - `mode` 'create' | 'update' | 'updateOrCreate' | 'replace' | 'append' | 'remove' | 'snapshot'
    - `model_ids` string[] — Model IDs used in the sync.
    - `name` string
    - `only_enrich_updates` boolean
    - `organization_id` string, uuid
    - `override_fields` OverrideField[]
      - `new` boolean — New is set to true if the target field should be created by Polytomic. This is not supported by all backends.
      - `override_value` string, required — Value written to the target field for every record.
      - `sync_mode` string — Sync mode for the field; defaults to 'updateOrCreate'. If set to 'create', the field will not be synced if it already has a value. This is not supported by all backends.
      - `target` string, required — Target field ID the value will be written to.
    - `overrides` Override[]
      - `field` Source
        - `field` string, required
        - `model_id` string, uuid, required
      - `field_id` string — Field ID of the model field to override.
      - `function` 'Equality' | 'Inequality' | 'IsNull' | 'IsNotNull' | 'True' | 'False' | 'OnOrAfter' | 'OnOrBefore' | 'GreaterThan' | 'GreaterThanEqual' | 'LessThan' | 'LessThanEqual' | 'StringContains' | 'StringStartsWith' | 'StringEndsWith' | 'StringDoesNotContain' | 'StringDoesNotStartWith' | 'StringDoesNotEndWith' | 'StringOneOf' | 'StringNotOneOf' | 'Between' | 'ArrayContains' | 'ArrayDoesNotContain' | 'InTheLast' | 'RelativeOnOrBefore' | 'RelativeOnOrAfter' | 'StringLike' | 'StringNotLike' | 'StringMatchesTrimmed'
      - `override` string
      - `value` string
    - `policies` string[]
    - `schedule` Schedule
      - `connection_id` string, uuid
      - `day_of_month` string, nullable
      - `day_of_week` string, nullable
      - `frequency` 'manual' | 'continuous' | 'hourly' | 'daily' | 'weekly' | 'custom' | 'builder' | 'runafter' | 'multi' | 'dbtcloud'
      - `hour` string, nullable
      - `job_id` integer, nullable
      - `minute` string, nullable
      - `month` string, nullable
      - `run_after` RunAfter
        - `bulk_sync_ids` string[]
        - `sync_ids` string[]
      - `run_after_success_only` boolean, nullable — If true, the sync will only run if the dependent syncs completed successfully.
    - `skip_initial_backfill` boolean
    - `sync_all_records` boolean
    - `target` Target
      - `configuration` object
      - `connection_id` string, uuid, required
      - `create` object — Create a new target object with these properties.
      - `filter_logic` string
      - `new_name` string — Name for a new target object.
      - `object` string
      - `search_values` object
    - `updated_at` string, date-time
    - `updated_by` OutputActor
      - `id` string, uuid
      - `name` string
      - `type` string

## Other responses

- `404` — Not Found
- `500` — Internal Server Error

---

[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/5e9bcd4cfb2d/schema)