Synup
Schlüssel erstellen
v1Ressourcen/Distribution/getStatus einer Kampagne abrufen

Status einer Kampagne abrufen

Gibt für jeden Zielbeitrag Status, Freigaben, Planung mit Zeitzone, Live-URLs und den letzten Fehler zurück, dazu den Status jeder Datei.

get/api/v1/distribution/campaigns/{id}
distribution:read
Query-Parameter
idstringerforderlich
Die vom Import zurückgegebene campaignId.
Antwort
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
Fehler
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/distribution/campaigns/{id}
Ihr API-Schlüssel
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
      }
    ]
  }
}

Neu bei der Synup-API?