GET Creative Moderation Comments
Retrieves comments associated with a creative, including rejection reasons, remediation guidance, and any prior appeal history.
URL: GET /api/v1/creatives/moderation/comments?creativeId={uuid of creative}&advertiserId={id of advertiser}
Query Parameters
| Parameter | Description | Type | Required | Possible Values |
|---|---|---|---|---|
| advertiserId | The ID for the specific advertiser | integer | Y | A valid advertiser ID |
| creativeId | The UUID of the creative | string | Y | A valid creative ID |
| filter | Values: resolved, unresolved | array | resolved, unresolved |
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/moderation/comments?creativeId=abcde-12345&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
| Element | Description | Type |
|---|---|---|
| creativeId | UUID of creative | string |
| name | name of creative | string |
| status | status. enum [DRAFT, PENDING_APPROVAL, APPROVED, REJECTED, PUBLISHED] | string |
| detailedStatus | enum[NEEDS_MORE_INFORMATION, CREATIVE_REVIEW, ESCALATION_REVIEW, APPEALED, NEW_INFO_PROVIDED, APPROVED, REJECTED] | string |
| decidedAt | timestamp of last reviewer decision | date-time |
| requestId | ID of the moderation request | string |
| prohibitedContentsCount | number of total prohibited content comments | integer |
| claimsContentsCount | number of total claims comments | integer |
| generalCommentsCount | number of total general comments | integer |
| reviewComments | comments The reviewComments objects are detailed | |
| appeals | appeals to rejected creatives
| string |
reviewComments Objects
| Element | Description | Type |
|---|---|---|
| unresolved | unresolved comments (not all fields all the time)
| string |
| resolved | unresolved comments (not all fields all the time)
| string |
NOTE: If asset = 'Photo 1', it refers to the main image.
Sample Response
{ "creativeId": "11111111-aaaa-aaaa-aaaa-111111111111", "name": "name of creative", "status": "PENDING_APPROVAL", "detailedStatus": "APPEALED", "decidedAt": "2026-01-28T19:50:25+00:00", "prohibitedContentsCount": 2, "claimsContentsCount": 2, "generalCommentsCount": 2, "resolvedCommentsCount": 2, "unResolvedCommentsCount": 2, "reviewComments": { "unresolved": [ { "commentId": "33333333-aaaa-aaaa-aaaa-333333333333", "type": "prohibitedContent", "policyId": "TEXT_PROH_ALCOHOL-ALCOHOL USE", "policyCategory": "alcohol-alcohol use", "policyName": "alcohol-alcohol use", "message": "Alcohol in any onsite media.", "adUnitName": "marqueeDesktop", "asset": "headline", "commentedAt": "2026-01-28T19:44:06+00:00" }, { "commentId": "33333333-aaaa-aaaa-aaaa-333333333333", "type": "claim", "policyId": "TEXT_CLAIM_FREE FROM CLAIMS", "policyCategory": "", "policyName": "Free From Claims", "message": "The submitted creative copy refers to brands or products with Green Claims such as \"bpa \".", "adUnitName": "marqueeDesktop", "asset": "subhead", "evidence": "bpa ", "commentedAt": "2026-01-28T19:44:06+00:00" }, { "commentId": "33333333-aaaa-aaaa-aaaa-333333333333", "type": "general", "message": "A general comment", "adUnitName": "galleryDesktop", "asset": "headline", "commentedAt": "2026-01-28T19:44:06+00:00" }... ], "resolved": [ { "commentId": "33333333-aaaa-aaaa-aaaa-333333333333", "type": "general", "message": "A general comment", "adUnitName": "galleryDesktop", "asset": "headline", "commentedAt": "2026-01-28T19:44:06+00:00" }... ] }, "appeals": [ { "description": "i want to appeal this", "attachments": [ "a document.docx" ], "submittedAt": "2026-01-28T19:54:33+00:00" } ]
} Updated about 7 hours ago