Docs durchsuchen

Guides und API-Endpunkte durchsuchen

Referenz

Status / Webhooks

Review-/Lieferstatus live abfragen (Pull) oder per registrierter Webhook-URL empfangen (Push).

Verfügbar
GET

/v1/meta/status/{ad_id}

Liefert den aktuellen effective_status einer Ad — live aus der Meta-API geholt und serverseitig zwischengespeichert. Bei DISAPPROVED wird der Ablehnungsgrund mitgegeben, damit die Kundenplattform ihn anzeigen und einen Retry ermöglichen kann.

Path-Parameter

NameTypPflichtBeschreibung
ad_idstring (UUID)erforderlichInterne Ad-ID (aus POST /v1/meta/ads). z. B. 9b2e7c11-3a4d-4f88-bb20-1c6e8a5d2f90

Request · Next.js

const ad_id = "9b2e7c11-3a4d-4f88-bb20-1c6e8a5d2f90";

const res = await fetch(`https://api.campaignkit.ventureon.io/v1/meta/status/${ad_id}`, {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.CAMPAIGNKIT_API_KEY}`,
    },
});
const data = await res.json();

Response 200

{
  "data": {
    "ad_id": "9b2e7c11-3a4d-4f88-bb20-1c6e8a5d2f90",
    "effective_status": "DISAPPROVED",
    "disapproval_reason": "Text-Overlay zu groß"
  },
  "request_id": "…"
}

effective_status ist auf ACTIVE | PAUSED | PENDING_REVIEW | DISAPPROVED | ARCHIVED normalisiert. disapproval_reason ist nur bei DISAPPROVED gesetzt, sonst null.