---
title: "Get Bulk Destination"
method: GET
path: "/api/connections/{id}/bulksync/target"
tags: ["Bulk Sync"]
---

# Get Bulk Destination

`GET /api/connections/{id}/bulksync/target`

Describes the destination configuration schema a connection accepts when used as a bulk sync destination.

The response is a JSON Schema object describing the shape of the
`destination_configuration` field you must supply when
[creating](../../../../../api-reference/bulk-sync/create) or
[updating](../../../../../api-reference/bulk-sync/update) a bulk sync that uses this
connection as its destination. Required fields vary by connection type.

> 📘 Fetch this endpoint once per connection type rather than once per sync.
> The configuration schema is the same for all syncs sharing the same
> destination connection.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- BulkSyncDestEnvelope
  - `data` BulkSyncDest
    - `configuration` object, nullable
    - `modes` SupportedBulkMode[], nullable
      - `description` string
      - `id` 'snapshot' | 'replicate', nullable
      - `label` string
      - `requires_identity` boolean
      - `supports_field_sync_mode` boolean
      - `supports_target_filters` boolean
    - `supported_resync_modes` BulkResyncMode[], nullable — Resync modes supported by this destination (refetch, resync, rebuild).

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `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)