Synup
Create a key
v1Resources/Distribution/getGet a campaign's status

Get a campaign's status

Returns each destination post's state, approvals, schedule with time zone, live URLs and last error, plus each file's status.

get/api/v1/distribution/campaigns/{id}
distribution:read
Query parameters
idstringrequired
The campaignId returned by the import.
Response
dataobjectoptional
campaignobjectoptional
variantsarray of objectoptional
keystringoptional
platformstringoptional
formatstringoptional
statestring (blocked | needs_review | changes_requested | ready | scheduled | paused | publishing | handoff | live | partial | failed)optional
blockersarray of stringoptional
approvalobjectoptional
suggestedForstringoptional
scheduledForstringoptional
timezonestringoptional
liveUrlsarray of objectoptional
lastErrorstringoptional
assetsarray of objectoptional
Errors
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/distribution/campaigns/{id}
Your API key
id *
{
  "data": {
    "campaign": {
      "id": "dcm_123",
      "clientId": "cli_123",
      "clientName": "Acme Dental",
      "externalId": "topic-local-seo-2026-10",
      "title": "Why local SEO still wins",
      "template": "topic",
      "subject": null,
      "currentVersion": 1,
      "paused": false,
      "archivedAt": null,
      "createdAt": "2026-10-01T10:00:00.000Z"
    },
    "variants": [
      {
        "key": "short-1-linkedin",
        "platform": "linkedin",
        "format": "video",
        "state": "scheduled",
        "blockers": [],
        "approval": {
          "editorial": "approved",
          "customer": "not_required",
          "publish": "approved",
          "revision": 1,
          "customerRequired": false
        },
        "suggestedFor": "2026-10-06T13:00:00.000Z",
        "scheduledFor": "2026-10-06T13:00:00.000Z",
        "timezone": "America/New_York",
        "liveUrls": [],
        "lastError": null
      }
    ],
    "assets": [
      {
        "id": "das_123",
        "externalId": "short-1",
        "version": 1,
        "status": "ready",
        "lastError": null
      },
      {
        "id": "das_124",
        "externalId": "short-1-cover",
        "version": 1,
        "status": "ready",
        "lastError": null
      }
    ]
  }
}

New to the Synup API?