API Error Codes and Throttling

This section provides you the list of expected HTTP response error codes while making the API calls to Walmart Connect Sponsored Search Advertising APIs.

Status Codes and Errors

Code Description Notes
200 OKThe request was successful
400 Bad RequestThe request was not properly formed and therefore was not successful
422Unprocessable EntityThe server understands the content type of the request entity, and the syntax of the request entity is correct, but it was unable to process the contained instructions
403 UnauthorizedInvalid credentials
404 Entity Not FoundEntity not found. (e.g. This exception will show up when wrong campaign ID is provided)
429Too Many RequestsNumber of requests have exceeded the calls per hour limit for the endpoint (Rate limit) for the integrator. Retry after 10 minutes.
500/520Internal Server ErrorAn internal server error has occurred
503Service Not Available Server is temporarily unable to handle the request. Try again later
521Service Not Available The origin server has refused the connection. Try again later

API Throttling

Rate limits on API operations

There is a rate limit in place on the allowed number of API operations per hour.

Operations per hour are computed as the sum of number of changes requested across all API requests during the hour.

For example, 5 keyword bid changes, creation of an ad group, adding an item, and a snapshot report request in any given hour, would be counted as 8 operations.

You will receive an HTTP 429 status error code and an error message about rule enforced in case of breaking ops limit.

To learn more about current applicable limits specific to your integration, please reach out to the API Partner Operations team.