---
updatedAt: 2026-04-12T09:22:44.000Z
---

# Fetch Review Status

Retrieve review status of ad group that is under review. You can retrieve this status for advertisers, based on advertiser ID and ad group ID

**Note:**

* If you provide only advertiser id, **all ad groups** for this advertiser with a review history will be returned.
* You will receive all historical reviews for an ad group in the response.
* You should check the status of review on an hourly cadence.
* To learn about SLA for review completion, please refer Sponsored Brands Guideline Document.

> 🌐 URL: ​GET/api/v1/review

# Query Parameters

| Parameter    | Description                                                    | type    | Required | Possible Values        |
| ------------ | -------------------------------------------------------------- | ------- | -------- | ---------------------- |
| adGroupId    | The ID of the ad group for which you want to retrieve reviews  | integer | N        | A valid ad group ID    |
| advertiserId | The ID of the advertiser                                       | integer | Y        | A valid advertiser ID  |

<br />

## 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                       |
| WM\_CONSUMER.ID          | 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  | Auth signature as an API key.                                                                                          | Y        | Use the signature generator code from Getting Started Guide to generate this value                                                               |
| WM\_SEC.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                                                               |
| Content-Type             | Format of the message body                                                                                             | Y        | application/json                                                                                                                                 |

## Sample Request

```
curl -X GET \ 
'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v1/review?adGroupId=700001&advertiserId=123456' \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer <auth_token>' \
  --header 'WM_SEC.AUTH_SIGNATURE: ***********' \
  --header 'WM_SEC.KEY_VERSION: 1' \ 
  --header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \ 
  --header 'WM_CONSUMER.intimestamp: 1565309779'\
```

# Response

[block:parameters]
{
  "data": {
    "h-0": "Element ",
    "h-1": "Description",
    "h-2": "Type",
    "0-0": "reviewId",
    "0-1": "ID of the review for advertiser ",
    "0-2": "integer",
    "1-0": "campaignID",
    "1-1": "ID of the campaign for whose ad group, the reviews are fetched ",
    "1-2": "integer",
    "2-0": "adGroupId",
    "2-1": "ID of the ad group  ",
    "2-2": "integer",
    "3-0": "reviewStatus",
    "3-1": "Specified status of campaign. Possible values of status are: pending, inProgress, complete, cancelled",
    "3-2": "string",
    "4-0": "reviewComments",
    "4-1": "Comments given as part of this review. This is an array holding following elements:<ul><li>commentType: The type of this particular comment for given advertiser ID and ad group ID. The data type is string.<ul><li>The possible types are: `content`, `keyword`</li></ul></li><li>comments: piece of text for this comment. The data type is string.</li></ul>Note: <ul><li>For each rejected item, you will receive a review reason. If it is “Other”, then refer to review comments in review response (“commentType” = “content”) for more details. </li><li>For rejected bidded keywords, you will receive a review reason as part of review response (“commentType” is “keyword” comment). Please refer to Sponsored Brands Guideline Document for keyword compliance. </li><li>For Sponsored Brands profile, “GET SBA profile” API endpoint will provide you a “reviewReason” if it is rejected</li></ul>",
    "4-2": "string"
  },
  "cols": 3,
  "rows": 5,
  "align": [
    null,
    null,
    null
  ]
}
[/block]

## Sample Response

```
[
  {
    "reviewId": "400001",
    "campaignId": "600002",
    "adGroupId": "200002",
    "reviewStatus": "pending",
    "reviewComments": 
           [
             { 
               "commentType": "content",
               "comments": "comment1"
            },

            {
               "commentType": "keyword",
               "comments": "comment2"
            }
               ]                 
    }  
  ] 
```