---
updatedAt: 2026-06-25T22:36:16.000Z
---

# All subscriptions

Use the All subscriptions API to retrieve every webhook subscription configured for your Walmart Marketplace account. Each record describes an event subscription (for example, OFFER\_UNPUBLISHED, PO\_CREATED) including the target URL, headers used during delivery, authentication details, and current status.

## How it works

1. You call the `GET /v3/webhooks/subscriptions` endpoint.
2. The service returns an events array. Each object represents one subscription with fields such as:
   1. `eventType` (examples: OFFER\_UNPUBLISHED, PO\_CREATED, PO\_LINE\_AUTOCANCELLED, BUY\_BOX\_CHANGED)
   2. `subscriptionId` (UUID)
   3. `partnerId` (your account identifier)
   4. `eventVersion `(example: V1)
   5. `resourceName` (examples: ITEM, ORDER, PRICE)
   6. `eventUrl `(your webhook endpoint)
   7. `headers` (header key/values sent on delivery)
   8. `authDetails` (for example, authMethod: BASIC\_AUTH)
   9. `status` (Allowed values: ACTIVE, INACTIVE)
3. Use the response to audit, monitor, or reconcile your webhook configuration.

## Endpoint

```Text bash
GET https://marketplace.walmartapis.com/v3/webhooks/subscriptions
```

## Sample request

```curl cURL
curl --request GET  
  --url <https://marketplace.walmartapis.com/v3/webhooks/subscriptions>  
  --header 'Accept: application/json'
```
```python
import requests

url = "https://marketplace.walmartapis.com/v3/webhooks/subscriptions"
headers = {
    "accept": "application/json"
}

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())  # or response.text if not JSON
```

### Modify your code

1. Set headers and add the OAuth 2.0 bearer token in the Authorization header of your request.
2. Send the request and confirm success criteria.

* **HTTP status**: 200 OK
* **Body**: JSON object with an events array (may be empty or contain multiple subscriptions).

4. Handle transient errors: On 429 or 5xx, retry with exponential backoff and random jitter. Log only non-sensitive request metadata (timestamp, path, status, duration, attempt, backoff delay) and do not include credentials.

## Sample response

### 200 response (Sample 1)

```json JSON
{  
  "events": [  
    {  
      "eventType": "OFFER_UNPUBLISHED",  
      "subscriptionId": "243ba4d0-b322-11ea-b385-0127e9b85538",  
      "partnerId": "10000000359",  
      "eventVersion": "V1",  
      "resourceName": "ITEM",  
      "eventUrl": "https://example.com/events",  
      "headers": {  
        "X-Custom-Header": "my-value"  
      },  
      "authDetails": {  
        "authHeaderName": "Authorization",  
        "authMethod": "BASIC_AUTH",  
        "userName": "abc",  
        "password": "test"  
      },  
      "status": "INACTIVE"  
    },  
    {  
      "eventType": "PO_CREATED",  
      "subscriptionId": "343ba4d0-b322-11ea-b385-0127e9b85538",  
      "partnerId": "10000000359",  
      "eventVersion": "V1",  
      "resourceName": "ORDER",  
      "eventUrl": "https://example.com/orders",  
      "headers": {  
        "X-Custom-Header": "my-value"  
      },  
      "authDetails": {  
        "authHeaderName": "Authorization",  
        "authMethod": "BASIC_AUTH",  
        "userName": "abc",  
        "password": "test"  
      },  
      "status": "ACTIVE"  
    }  
  ]  
}
```

### 200 response (Sample 2)

```json JSON
{  
  "events": [  
    {  
      "eventType": "OFFER_UNPUBLISHED",  
      "subscriptionId": "243ba4d0-b322-11ea-b385-0127e9b85538",  
      "partnerId": "10000000359",  
      "eventVersion": "V1",  
      "resourceName": "ITEM",  
      "eventUrl": "https://example.com/events",  
      "headers": {  
        "X-Custom-Header": "my-value"    
      },  
      "authDetails": {  
        "authHeaderName": "Authorization",  
        "authMethod": "BASIC_AUTH",  
        "userName": "abc",  
        "password": "test"  
      },  
      "status": "INACTIVE"  
    },  
    {  
      "eventType": "PO_CREATED",  
      "subscriptionId": "343ba4d0-b322-11ea-b385-0127e9b85538",  
      "partnerId": "10000000359",  
      "eventVersion": "V1",  
      "resourceName": "ORDER",  
      "eventUrl": "https://example.com/orders",  
      "headers": {  
        "X-Custom-Header": "my-value"    
      },  
      "authDetails": {  
        "authHeaderName": "Authorization",  
        "authMethod": "BASIC_AUTH",  
        "userName": "abc",  
        "password": "test"  
      },  
      "status": "ACTIVE"  
    },  
    {  
      "eventType": "PO_LINE_AUTOCANCELLED",  
      "subscriptionId": "243ba4d0-b322-11ea-b385-0127e9b85538",  
      "partnerId": "10000000359",  
      "eventVersion": "V1",  
      "resourceName": "ORDER",  
      "eventUrl": "https://example.com/events",  
      "headers": {  
        "X-Custom-Header": "my-value"    
      },  
      "authDetails": {  
        "authHeaderName": "Authorization",  
        "authMethod": "BASIC_AUTH",  
        "userName": "abc",  
        "password": "test"  
      },  
      "status": "ACTIVE"  
    },  
    {  
      "eventType": "BUY_BOX_CHANGED",  
      "subscriptionId": "243ba4d0-b322-11ea-b385-0127e9b85538",  
      "partnerId": "10000000359",  
      "eventVersion": "V1",  
      "resourceName": "PRICE",  
      "eventUrl": "https://example.com/events",  
      "headers": {  
        "X-Custom-Header": "my-value"    
      },  
      "authDetails": {  
        "authHeaderName": "Authorization",  
        "authMethod": "BASIC_AUTH",  
        "userName": "abc",  
        "password": "test"  
      },  
      "status": "ACTIVE"  
    }  
  ]  
}
```

<br />