GET Creative Moderation-Assist Results
Use this API to get moderation-assist results for the prior job.
Returns the result of an asynchronous call. Minimum 30-second wait required before polling; multiple poll attempts may be necessary.
URL: GET /api/v1/creatives/{creativeId}/moderation-assist/{jobId}?advertiserId={id of advertiser}
Path Parameters
| Parameter | Description | Type | Required | Possible Values |
|---|---|---|---|---|
| creativeId | The UUID of the creative | string | Y | A valid creative ID |
| jobId | UUID of moderation-assist job | string | Y | A valid job ID |
Query Parameters
| Parameter | Description | Type | Required | Possible Values |
|---|---|---|---|---|
| advertiserId | The ID for the specific advertiser | integer | Y | A valid advertiser ID |
Headers
| Header Name | Description | Required | Values |
|---|---|---|---|
| Authorization | The token will provide you the access to the API. It is same for all advertisers you access through the API. | Y | Please utilize the generated auth_token shared with you at the time of partner onboarding from the Getting Started Guide |
| Content-Type | Format of the message body | Y | application/json |
| WM_CONSUMER.ID | Unique ID for consumer. We will provide you the consumer ID to access the API. It is same for all advertisers you access through the API. | Y | Please use the generated ConsumerId shared with you at the time of partner onboarding. Refer to the Getting Started Guide for more information |
| WM_SEC.AUTH_SIGNATURE | Signature for authentication | Y | Use the signature generator code from Getting Started Guide to generate this value |
| WM_SEC.KEY_VERSION | Key version. We will provide you with the KEY VERSION to access the API. It is same for all advertisers you access through the API. | Y | 1 |
| WM_CONSUMER.intimestamp | Timestamp for which the auth signature is generated. Use Unix epoch format for the timestamp. | Y | Use the signature generator code from Getting Started Guide to generate this value |
Sample Request
curl -X GET \
--location 'https://developer.api.us.stg.walmart.com/api-proxy/service/display/api/v1/api/v1/creatives/11111111-aaaa-aaaa-aaaa-111111111111/moderation-assist/22222222-aaaa-aaaa-aaaa-222222222222?advertiserId=123' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'WM_CONSUMER.ID: <consumer id>' \
--header 'WM_SEC.KEY_VERSION: 1' \
--header 'WM_CONSUMER.INTIMESTAMP: 0000000000000' \
--header 'WM_SEC.AUTH_SIGNATURE: <token>' Response - if moderation-assist results are still Pending
| Element | Description | Type |
|---|---|---|
| jobId | UUID of async job | string |
| status | status. The value of status is PENDING | string |
Sample Response - if moderation-assist results are still Pending
{ "jobId": "22222222-aaaa-aaaa-aaaa-222222222222", "status": "PENDING"
}
Response - if moderation-assist results are complete
| Element | Description | Type |
|---|---|---|
| jobId | UUID of moderation-assist job | string |
| status | status. enum values: PENDING, COMPLETED, FAILED | string |
| requestId | ID of the moderation request | string |
| creativeId | UUID of creative | string |
| name | name of creative | string |
| prohibitedContents | list of violations that will most likely result in the creative being rejected if submitted.
| string |
| acknowledgementClaims | list of claims that require submitting an acknowledgement after submitting the creative. Use POST /api/v1/creatives/moderation/submission with type=ACKNOWLEDGE
| string |
| substantiationClaims | list of claims that require submitting substantiation after submitting the creative. Use POST /api/v1/creatives/moderation/submission with type=ADDTIONAL_INFO
| string |
| altText | list of suggested alt-text for each ad unit image
| string |
| totalCount |
| |
| createdAt | ISO 8601 timezone format: yyyy-MM-dd'T'HH:mm:ssZ | string |
NOTE: If asset = 'Photo 1', it refers to the main image.
Sample Response - if moderation-assist results are complete
{ "jobId": "22222222-aaaa-aaaa-aaaa-222222222222", "requestId": "<id of request>", "creativeName": "the creative name", "status": "COMPLETED", "creativeId": "11111111-aaaa-aaaa-aaaa-111111111111", "prohibitedContents": [ { "policyId": "TEXT_PROH_ALCOHOL-ALCOHOL USE", "policyCategory": "alcohol-alcohol use", "policyName": "alcohol-alcohol use", "message": "Alcohol in any onsite media.", "adUnitName": "marqueeDesktop", "asset": "headline" }, … ], "acknowledgementClaims": [ { "policyId": "TEXT_CLAIM_FREE FROM CLAIMS", "policyCategory": "", "policyName": "Free From Claims", "message": "The submitted creative copy refers to brands or products with Free From Claims such as \"plastic free \".", "adUnitName": "marqueeDesktop", "asset": "headline", "evidence": "plastic free " }, … ], "substantiationClaims": [ { "policyId": "TEXT_CLAIM_GREEN CLAIMS", "policyCategory": "", "policyName": "Green Claims", "message": "The submitted creative copy refers to brands or products with Green Claims such as \"organic cotton, bpa free \".", "adUnitName": "marqueeDesktop", "asset": "subhead", "evidence": "organic cotton, bpa free " }, … ], "altText": [ { "adUnitName": "brandboxApp", "suggestedAltText": "A notebook glasses and a computer on a desk" },
… ], "totalCount": { "prohibitedContents": 14, "acknowledgementClaims": 14, "substantiationClaims": 9, "altText": 13 }, "createdAt": "2026-02-05T22:08:09Z"
}
Updated about 7 hours ago