--- updatedAt: 2026-06-25T19:32:13.000Z --- # All subscriptions Retrieve details of all webhook subscriptions created using the Create Subscription API. Use query parameters to filter by subscription ID, event type, resource, or status. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Notifications Management", "version": "1.0", "description": "Notifications Management API" }, "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Production URL" }, { "url": "https://sandbox.walmartapis.com", "description": "Sandbox URL" } ], "security": [ { "basicScheme": [] } ], "paths": { "/v3/webhooks/subscriptions": { "get": { "tags": [ "Notifications" ], "summary": "All subscriptions ", "description": "Retrieve details of all webhook subscriptions created using the Create Subscription API. Use query parameters to filter by subscription ID, event type, resource, or status.", "operationId": "getAllSubscriptions", "parameters": [ { "name": "subscriptionId", "in": "query", "description": "Filter results to a specific subscription by its unique identifier.", "required": false, "schema": { "type": "string" } }, { "name": "eventType", "in": "query", "description": "Filter results to a specific event type. Refer to the Event Payload section for the list of available event types.", "required": false, "schema": { "type": "string" } }, { "name": "resourceName", "in": "query", "description": "Filter results to a specific resource (functional category). Refer to the Event Payload section for the list of available resource names.", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "description": "Filter results by subscription status. Allowed values: ACTIVE, INACTIVE.", "required": false, "schema": { "type": "string" } }, { "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.", "required": true, "schema": { "type": "string" }, "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....." }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "description": "A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.", "required": false, "schema": { "type": "string" } }, { "in": "header", "name": "WM_QOS.CORRELATION_ID", "description": "A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.", "required": true, "schema": { "type": "string" }, "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Name of the Walmart service being called.", "required": true, "schema": { "type": "string" }, "example": "Walmart Marketplace" } ], "responses": { "200": { "description": "Successful Operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "events": { "type": "array", "description": "List of subscriptions that match the request filters.", "items": { "type": "object", "properties": { "event": { "type": "array", "items": { "type": "object", "properties": { "eventType": { "type": "string", "description": "Event type for which the subscription was created." }, "subscriptionId": { "type": "string", "description": "Unique identifier for the subscription. Use this ID to retrieve, update, or delete the subscription." }, "partnerId": { "type": "string", "description": "Partner ID of the seller who created the subscription." }, "eventVersion": { "type": "string", "description": "Version of the event type for which the subscription was created." }, "resourceName": { "type": "string", "description": "Resource (functional category) that the event type is mapped to (for example, ITEM, ORDER, PRICE)." }, "status": { "type": "string", "description": "Subscription status. Allowed values: ACTIVE, INACTIVE." }, "eventUrl": { "type": "string", "description": "Destination URL where notifications are delivered." }, "authDetails": { "type": "object", "properties": { "authMethod": { "type": "string", "description": "Authentication method for the destination URL. Allowed values: BASIC_AUTH, OAUTH, HMAC." }, "userName": { "type": "string", "description": "Username used to access the destination URL (required for BASIC_AUTH)." }, "password": { "type": "string", "description": "Password used to access the destination URL (required for BASIC_AUTH)." }, "authHeaderName": { "type": "string", "description": "Header name used to pass the authorization value to the destination URL (for example, Authorization)." }, "authUrl": { "type": "string", "description": "OAuth server or token URL used when the authentication method is OAUTH." }, "clientSecret": { "type": "string", "description": "Client secret used with the OAuth server (OAUTH) or as key material for HMAC." }, "clientId": { "type": "string", "description": "Client ID used with the OAuth server when the authentication method is OAUTH." } }, "description": "Authentication details for accessing the destination URL, if the URL is protected." }, "headers": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Additional HTTP headers to include when delivering notifications to the destination URL. Use for custom authentication headers, tracking identifiers, or any other headers your endpoint requires." } } }, "description": "Array of subscription objects returned by the service." } }, "description": "List of events" } } } }, "examples": { "sample1": { "value": { "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" } ] } }, "sample2": { "value": { "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" } ] } } } } } } } } } } } ```