---
updatedAt: 2026-07-14T18:05:27.000Z
---

# List All The Ad Group

This API allows you to fetch all the available ad group. Provide the advertiser unique ID in the request to fetch the details. The response includes key details about each ad group enabling you to view and manage all ad groups under a specific advertiser account.

[block:html]
{
  "html": "<a\n  href=\"https://www.postman.com/walmartconnecttechnicalsolutions/walmart-connect-sponsored-search-ads-api/collection/oi3xem2/wmc-sponsored-search-api-partner-onboarding\"\n  target=\"_blank\"\n  style=\"text-decoration: none\"\n>\n  <button>\n    <img\n      src=\"https://run.pstmn.io/button.svg\"\n      alt=\"Run In Postman\"\n      style=\"width: 128px; height: 32px\"\n    />\n  </button>\n</a>"
}
[/block]

<br />

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "description": "Staging URL:     https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/ \nProduction URL : https://developer.api.walmart.com/api-proxy/service/WPA/Api/v1/ \n\nThe Walmart Sponsored Products API enables programmatic access to campaign management and reporting, allowing you to automate, scale, and optimize your advertising. Our flexible solution will allow you to integrate with Sponsored Products in a way that meets your goals and objectives. The API functionalities include campaign and ad group creation, bid and budget adjustments, campaign scheduling, and performance reporting. \n\nNote: POST request to create new entities. PUT request should only include the attribute which needs to be updated and Id for which PUT request is fired for.",
    "title": "Walmart Sponsored Products API",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    },
    {
      "consumer_id": []
    },
    {
      "timestamp": []
    },
    {
      "auth_signature": []
    }
  ],
  "tags": [
    {
      "description": "AdGroup management",
      "name": "AdGroup"
    }
  ],
  "paths": {
    "/api/v1/adGroups": {
      "get": {
        "description": "This API allows you to fetch all the available ad group. Provide the advertiser unique ID in the request to fetch the details. The response includes key details about each ad group enabling you to view and manage all ad groups under a specific advertiser account.",
        "operationId": "AdGroupList",
        "parameters": [
          {
            "description": "The ID of the advertiser for whom the ad groups should be returned.",
            "in": "query",
            "name": "advertiserId",
            "required": true,
            "schema": {
              "format": "int32",
              "type": "integer"
            }
          },
          {
            "description": "The ID of the campaign for which the ad groups should be returned.",
            "in": "query",
            "name": "campaignId",
            "required": false,
            "schema": {
              "format": "int32",
              "type": "integer"
            }
          },
          {
            "description": "A valid ad group name with which the desired ad group can be searched in the absence of ad group ID.",
            "in": "query",
            "name": "filter[name]",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Provide a date to fetch only those ad groups which were modified on or after that date.\n\n***Note:***\n- *If there was any change to the ad group set up.*\n- *If any item or keyword was modified/added/removed for relevant ad groups.*\n",
            "in": "query",
            "name": "filter[lastModifiedDate]",
            "required": false,
            "schema": {
              "format": "date",
              "type": "string"
            }
          },
          {
            "description": "Auth signature as an API key.",
            "in": "header",
            "name": "WM_SEC.AUTH_SIGNATURE",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "We will provide you the consumer ID to access the API. It is same for all advertisers you access through the API.",
            "in": "header",
            "name": "WM_CONSUMER.ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "We will provide you with the KEY VERSION to access the API. It is same for all advertisers you access through the API.",
            "in": "header",
            "name": "WM_SEC.KEY_VERSION",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Timestamp for which the auth signature is generated. Use Unix epoch format.",
            "in": "header",
            "name": "WM_CONSUMER.intimestamp",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "The token will provide you the access to the API. It is same for all advertisers you access through the API.",
            "in": "header",
            "name": "Authorization",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "*/*": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AdGroup"
                  },
                  "type": "array"
                }
              }
            },
            "description": "successful operation"
          }
        },
        "security": [
          {
            "auth_token": [],
            "consumer_id": [],
            "timestamp": [],
            "auth_signature": [],
            "key_version": []
          }
        ],
        "summary": "List All The Ad Group",
        "tags": [
          "AdGroup"
        ],
        "x-accepts": "*/*",
        "x-tags": [
          {
            "tag": "AdGroup"
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "AdGroup": {
        "description": "Details about the ad group",
        "properties": {
          "adGroupId": {
            "description": "ID of the ad group.",
            "example": 987654321,
            "format": "int32",
            "type": "integer"
          },
          "name": {
            "description": "Name of the ad group.",
            "example": "AdGroup name",
            "type": "string"
          },
          "status": {
            "description": "Specified status of ad group.",
            "enum": [
              "enabled",
              "disabled",
              "deleted"
            ],
            "type": "string"
          },
          "campaignId": {
            "description": "ID of the campaign associated with the respective ad group.",
            "example": 123456789,
            "format": "int32",
            "type": "integer"
          }
        },
        "type": "object"
      }
    }
  },
  "x-original-swagger-version": "2.0"
}
```