ReferenceImage API

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:

  1. Verify the URL used to connect to the API and make sure the address starts with https://.
  2. 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.
  3. If the partner's system is behind a firewall, make sure that port 443 is opened for connection to Expedia's production environment.
  4. 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