API platform status

Market availability: US only

The API Platform Status endpoint provides a consolidated view of Walmart Marketplace API health by API group. Use it to quickly triage whether an issue is likely platform-wide (for example, Items, Orders, Returns) or isolated to your integration.

Endpoint

GET /v3/utilities/apiStatus

Function

You can use this API to check on platform wide issues with:

  • Orders
  • Returns
  • Items
  • Inventory
  • Authentication
  • Marketplace services

Request sample

curl --request GET \ --url https://marketplace.walmartapis.com/v3/utilities/apiStatus \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: us' \ --header 'accept: application/json'

Modify your code

1. Verify the API endpoint

https://marketplace.walmartapis.com/v3/utilities/apiStatus

2. Specify the Market

Example:

--header 'WM_MARKET: us'

3. Include authentication credentials

Ensure the request includes the required Walmart Marketplace authentication headers and a valid access token, as applicable to your integration.

Response samples

200

{ "apiStatuses": [ { "apiGroup": "Returns", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Items", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Sandbox", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Lagtime", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Promos", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Orders", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Authentication", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Price", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Refunds", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Authorization", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" }, { "apiGroup": "Inventory", "status": "OPERATIONAL", "lastUpdatedTime": "2022-01-12T07:30:48.611Z" } ]
}

403

{ "error": [ { "code": "FORBIDDEN.GMP_GATEWAY_API", "field": "MarketNotSupported.", "description": "This capability isn’t available for the market you requested. Refer to the market availability within the API reference section for this API on <https://developer.walmart.com/> for details.", "info": "Access denied.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

Result

API status information

  • apiStatuses: the API status
  • apiGroup: The Marketplace API group
  • status: The status of the API group
  • lastUpdatedTime: When the API group status was last updated

Next steps

  • Add API status checks to your runbooks.
  • When you detect non-operational status, retry with backoff and consider pausing non-critical workflows until the platform recovers.

Did this page help you?