Guides
My Account

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

GET https://marketplace.walmartapis.com/v3/webhooks/subscriptions

Sample request

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

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).
  1. 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)

{ "events": [ { "eventType": "OFFER_UNPUBLISHED", "subscriptionId": "243ba4d0-b322-11ea-b385-0127e9b85538", "partnerId": "10000000359", "eventVersion": "V1", "resourceName": "ITEM", "eventUrl": "https://example.com/events", "headers": { "content-type": "application/json" }, "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": { "content-type": "application/json" }, "authDetails": { "authHeaderName": "Authorization", "authMethod": "BASIC_AUTH", "userName": "abc", "password": "test" }, "status": "ACTIVE" } ] }

200 response (Sample 2)

{ "events": [ { "eventType": "OFFER_UNPUBLISHED", "subscriptionId": "243ba4d0-b322-11ea-b385-0127e9b85538", "partnerId": "10000000359", "eventVersion": "V1", "resourceName": "ITEM", "eventUrl": "https://example.com/events", "headers": { "content-type": "application/json" }, "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": { "content-type": "application/json" }, "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": { "content-type": "application/json" }, "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": { "content-type": "application/json" }, "authDetails": { "authHeaderName": "Authorization", "authMethod": "BASIC_AUTH", "userName": "abc", "password": "test" }, "status": "ACTIVE" } ] }

Updated 1 day ago