Error handling
Error messaging in Image API helps you understand why a read, create, or update request is denied. Expedia Group recommends a robust retry strategy when resolving errors. Details about self-testing will be provided by your Integration Specialist.
Connectivity errors
Connectivity errors may occur when communication disruption occurs between Expedia Group and your software.
If the problem is:
- Connection timeout (before establishing connection)
- Cannot resolve host name
- Cannot establish connection
Before looking for assistance, you should:
- Verify the URL used to connect to the API and make sure the address starts with https://.
- Verify the domain name, and make sure that the address you are using is the right one for the environment you are targeting. Do not try to send QA information to production, or vice-versa.
- If the partner's system is behind a firewall, make sure that port 443 is opened for connection to Expedia's production environment.
- Retry. If additional assistance is required, contact us.
HTTP status codes
The API will leverage HTTP status codes as defined by RFC 2616, Section 10. Users should expect HTTP status codes from the API as indicated in the table below.
Status Code | Meaning | Retry |
|---|---|---|
200 | Success for read and update operations | No subsequent action needed |
201 | Success for create operations | No subsequent action needed |
204 | Success for delete operations | No subsequent action needed |
400 | Errors due to user due to incorrect input | Fix input and retry |
401 | Authentication error | Verify and retry |
403 | Authorization error | Verify and retry |
404 | Invalid resource | |
405 | Invalid/unsupported method on resource | |
406 | Unsupported media type for response (only application/json is supported) | |
415 | Unsupported media type for requests (only application/json is supported) | |
500 | Internal system error (should not be retried) | No |
503 | Temporary internal system error (should be retried) | Yes |
504 | Timeout error (should be retried) | Yes |
Error codes
HTTP status code | Error code | Error description | Explanation and recommended action | Retry? |
|---|---|---|---|---|
400 | 2002 | Bad Request | There is a problem with the submitted payload. Please make sure it's a valid JSON message. | Fix input and retry |
400 | 2003 | Bad Request | The property or element "[element]" is or contains invalid/unrecognizable data. | Fix input and retry |
400 | 2420 | Bad Request | Element [element] has to be a valid date formatted as YYYY-MM-DD. | Fix input and retry |
400 | 2421 | Bad Request | Element [element] has to be an integer. | Fix input and retry |
400 | 2422 | Bad Request | Element [element] has to be a double. | Fix input and retry |
400 | 2423 | Bad Request | Invalid Boolean value for element [element], has to be true or false. | Fix input and retry |
400 | 2424 | Bad Request | Invalid value '[value]' for the element '[element]'. | Fix input and retry |
400 | 2425 | Bad Request | Element [element] has to be a long. | Fix input and retry |
400 | 2426 | Bad Request | Invalid value for element '[element]'. | Fix input and retry |
400 | 2427 | Bad Request | Element [element] has to be a valid date/time formatted as yyyy-MM-dd HH:mm:ss.SSS z (e.g. 2016-01-01 08:00:00.000 America/Montreal). | Fix input and retry |
400 | 3203 | Bad Request | Room type ID not found [[roomTypeId]]. You specified a room type ID that does not exist for this property. | Fix input and retry |
400 | 3800 | Bad Request | Element "[element]" cannot be provided in the request for this operation. | Fix input and retry |
400 | 3801 | Bad Request | Element "[element]" is missing. | Fix input and retry |
400 | 3802 | Bad Request | [Media Service API validation error] | Fix input and retry |
400 | 3804 | Bad Request | We couldn't access the file at location [location]. If this is the first time you use this API, please contact Expedia Group to ensure Expedia Group is configured to access this location. | Fix input and retry |
400 | 3805 | Bad Request | Invalid category code provided. | Fix input and retry |
400 | 3806 | Bad Request | You are attempting a PATCH on an Image [image] that belongs to a different property [property] than the one in the request [property]. If you are trying to copy images from one property to another, please create a new image using POST method. | Fix input and retry |
400 | 3807 | Bad Request | Cannot add additional images to property [property]. Maximum count of images [count] exceeded for this property. Actual number of images: [count]. Please remove some images before trying to add more. | Fix input and retry |
403 | 1000 | Forbidden | You are not authorized to view this resource. | Verify and retry |
404 | 2404 | Not Found | Resource not found: the server has not found anything matching the Request-URI. | |
500 | 4100 | Internal Server Error | Internal System Error. Do not retry this request. Our support team was notified of the problem. | No. |
500 | 4101 | Internal Server Error | Internal System Error. Do not retry this request. Our support team was notified of the problem. | No. |
503 | 4000 | Service Unavailable | Internal system error, please try again in a few minutes. | Yes |