Get an Ad Creative
Fetch a single ad creative by its unique identifier.
URL
GET https://api.ads.apple.com/v1/creatives/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string |
Header Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | CreativeResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 404 | Not Found Content-Type: application/json | ErrorResponse | |
| 429 | Too Many Requests Content-Type: application/json | ErrorResponse | |
| 500 | Internal Server Error Content-Type: application/json | ErrorResponse |
Discussion
This endpoint retrieves a single ad creative by its unique identifier. The response includes the full ad creative object, including type, spec, destination, current review state, and eligibility details.
The systemStatus field conveys the ad creative’s current operational state, reflecting the internal review outcome. To determine whether the ad creative is eligible to serve, check systemStatus (VALID, INVALID, PENDING) together with the eligibility.status field.
Understand System Status and Ad Delivery
While systemStatus is PENDING, any ads associated with this ad creative will also have systemStatus: NOT_RUNNING and won’t deliver impressions. Once the ad creative reaches VALID, associated ads resume normal delivery, provided the ad group and campaign are also active.
The eligibility object in the response describes any policy or content restrictions that apply to the ad creative. This can include blocked countries, restricted placements, or content category limitations that affect where the ad creative is allowed to serve.
A couple of edge cases are worth calling out when fetching an ad creative by ID.
Constraint | Detail |
|---|---|
Deleted ad creatives | Fetching a deleted ad creative by ID returns a 404. Use the query endpoint with |
Eligibility details | The system populates the |