GET /v1/projects/:projectId/ads/:platform/reviews
Read platform ad-approval / disapproval state. Apple Ad Approval is the canonical use case.
GET
/v1/projects/:projectId/ads/{platform}/reviewsPhase 1stable
- Auth
- Bearer
- Scope
- ads:read
Lists ad-approval state per platform. Apple Search Ads' Ad Approval review can take hours; Layers polls and exposes status here so partners don't have to.
For real-time notification, subscribe to the approval.approved and approval.disapproved webhooks (D40).
Path parameters
projectIdstring (uuid)requiredplatformstringrequiredOne of:meta,tiktok,apple
Query parameters
statusstringoptionalOne of:pending_review,approved,disapprovedsincestring (ISO 8601, UTC Z)optionalcursorstringoptionallimitintegeroptionaldefault: 50
Response
{
"items": [
{
"reviewId": "rev_01HZX9...",
"adId": "ad_01HZX9...",
"adsContentId": "adc_6f5d4c3b...",
"platform": "apple",
"status": "disapproved",
"platformReason": "Trademark on 'Coffee'",
"submittedAt": "2026-05-08T10:00:00Z",
"decidedAt": "2026-05-08T14:32:11Z"
}
],
"nextCursor": null
}