---
title: "Retrieve a marketing platform sync"
method: GET
path: "/marketing-platform-syncs/{sync_history}"
tags: ["MarketingPlatformSyncs"]
---

# Retrieve a marketing platform sync

`GET /marketing-platform-syncs/{sync_history}`

## Request

- Base URL: `https://enterprise.knak.io/api/published/v1`
- URL: `https://enterprise.knak.io/api/published/v1/marketing-platform-syncs/{sync_history}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/knak/apis/knak-enterprise-api/docs/marketing-platform-syncs/:sync_history/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a specific [marketing platform sync](#tag/marketing_platform_sync) for status polling.

## Path parameters

- `sync_history` string, required

## Response `200`

OK

- MarketingPlatformSyncItem
  - `data` MarketingPlatformSync
    - `type` string
    - `id` string
    - `attributes` MarketingPlatformSyncAttributes
      - `id` string
      - `asset_id` string
      - `integration_id` string
      - `platform` string
      - `sync_type` 'sync' | 'resync'
      - `status` 'pending' | 'in_progress' | 'complete' | 'failed' | 'confirmation_requested': Wire value; the database stores `error` for failed syncs but the API response maps that to `failed` for consistency.
      - `platform_asset_id` string, nullable
      - `platform_asset_url` string, nullable
      - `error_message` string, nullable
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/knak/apis/knak-enterprise-api.md) - [All operations](https://skmtc.dev/knak/apis/knak-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knak/apis/knak-enterprise-api/revisions/31d2c94edfcc?raw)