Error codes and messages

When you send Bing your Price feed (formerly Transaction message) to process, Bing may return one of the following HTTP status codes:

Status Code Description
200 Success. Bing successfully queued the message to be processed.
401 Unauthorized. The user is not authorized to use the API or the message was sent from an IP address that is unknown to Bing or that is not associated with the user. To determine the cause, see the error message.
413 Request entity too large. The Price feed must not exceed 100 MB or 10 MB compressed.
429 Too many requests. You may have a maximum of five requests queued or being processed at the same time. If you send a sixth request at this time, Bing returns this error.
500 Internal server error. This is typically a transient error. Retry the request at 1, 5, and 20 minute intervals. If the request fails after the third attempt, contact your TAM with the following information:

  • CustomerID
  • Date and time that the errors occurred.
  • The ID in the WebRequestActivityId response header.

Response body

If an HTTP error occurs, the body of the response contains an XML document that contains a description of the error.

<ArrayOfApiError xmlns="http://schemas.datacontract.org/2004/07/Microsoft.BingAds.BHAC.HotelAdsAPIs.Models" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ApiError>
    <Code>IPAddressNotAllowed</Code>
    <Message>Customer 4 is not authorized to use IP address 167.220.24.77.</Message>
    <Property i:nil="true"/>
  </ApiError>
</ArrayOfApiError>

The following tables describe the elements found in the error response.

Error Response

Defines the top-level element of an error response.

Element Description Children
ArrayOfApiError The top-level element of an error response. This element contains a list of errors that occurred. Array of ApiError

ApiError

Defines an error that occurred.

Element Description Children
Code A code that identifies the error that occurred. For example, IPAddressNotAllowed. None
Message A message that describes the error that occurred. None
Property The name of the property that caused the error. If the error is not related to a property, the element's nil attribute is set to true. None

Codes and messages

The following lists the error codes and messages that the API returns.

Code Message
AuthenticationFailure Authentication failed for unknown reasons.
InternalError Internal server error.

This is typically a transient error. Retry the request at 1, 5, and 20 minute intervals. If the request fails after the third attempt, contact your TAM with the following information:

  • CustomerID
  • Date and time that the errors occurred.
  • The ID in the WebRequestActivityId response header.
IPAddressNotAllowed Customer {custId} is not authorized to use IP address {clientIp}.

The customer is not authorized to send Price feeds from the IP address. You must send the request from an authorized server IP address. Contact your TAM to update your list of authorized server IP addresses.
NotAuthorized The OAuth token that you set the Authorization header to is not valid.
RequestThrottled Customer {customerId} exceeded the number of requests allowed.

Customers may have a maximum of five requests queued or being processed. Sending a sixth request in this case will fail.
RequestTooLarge The request size ({requestSizeBytes} bytes) exceeds the maximum allowed ({maxAllowed} bytes).

The Price feed cannot exceed 100 MB or 10 MB compressed. Reduce the size of your Price feed to fit within the limits.