---
title: "Get Bulk Sync Schemas"
method: GET
path: "/api/bulk/syncs/{id}/schemas"
tags: ["Bulk Sync"]
---

# Get Bulk Sync Schemas

`GET /api/bulk/syncs/{id}/schemas`

Lists the schemas (tables, objects) configured for a bulk sync.

This endpoint returns the schemas that have been added to and configured on this
specific bulk sync — not the full set of schemas available from the source
connection. To discover what the source connection exposes, use the source
schemas endpoint for the relevant connection type.

Each schema in the response includes its sync mode, field selections, and any
custom configuration applied via
[`PATCH /api/bulk/syncs/{id}/schemas`](../../../../../api-reference/bulk-sync/schemas/patch)
or
[`PUT /api/bulk/syncs/{id}/schemas/{schema_id}`](../../../../../api-reference/bulk-sync/schemas/update).

## Path parameters

- `id` string, uuid, required — Unique identifier of the bulk sync.

## Query parameters

- `filters` object — Optional filters applied to the returned schemas. Supports enabled=true to return only enabled schemas and enabled=false to return only disabled schemas.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- ListBulkSchemaEnvelope
  - `data` BulkSchemaListItem[], nullable
    - `data_cutoff_timestamp` string, date-time, nullable — Per-schema cutoff. Records older than this timestamp are excluded from sync runs.
    - `disable_data_cutoff` boolean — When true, the sync ignores any configured data_cutoff_timestamp and syncs the full history of this schema.
    - `enabled` boolean — Whether this schema is included in sync runs.
    - `id` string — Source-side schema identifier (e.g. object name for SaaS sources, schema.table for databases).
    - `output_name` string — Effective name of the object written to the destination after any configured naming rules are applied.
    - `partition_key` string — Source field used to partition rows when writing to the destination. Empty if the destination does not require one.
    - `tracking_field` string — Source field used to detect changes between incremental sync runs. Empty if the schema performs full resyncs.
    - `user_output_name` string — User-specified override for the destination object name. When empty, output_name is used.

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