Skip to main content
The Best Price API uses JSON for most responses. The exact body shape depends on the status code.

​
Content type

​
Response codes

​
200 OK

The request was processed successfully. The response body is a JSON array:
  • Calendar: one entry per arrival date in the requested period.
  • Rates, Rooms, and Hotels (Arrivals): one entry per rate, room, or hotel and per requested behaviours value, with the best price over the period and the arrival date it applies to. With a single value in behaviours, that is one entry per rate, room, or hotel.
  • Hotels (Stays): one entry per hotel for the requested stay.

​
400 Bad Request

The request body failed validation or violated a business rule. The response carries a structured payload describing the problem. Every body includes at least title and status. The other fields appear depending on the type of issue.
​
string
Short, human-readable summary of the problem.
​
integer
HTTP status code, repeated in the body.
​
string
Human-readable explanation specific to this occurrence.
​
string
URI identifying the problem type.
​
object
Map of field path to the list of validation messages for that field.
​
string
Trace identifier, useful when contacting support.

​
Validation errors

Schema-level validation errors include an errors map. Each key is the path to the field that failed validation, and the value is the list of error messages.

​
Business rule errors

Business rule violations include a detail field with the specific cause.

​
401 Unauthorized

The OAuth signature was missing, malformed, or rejected. Common causes:
  • The signature does not match the consumer or token secret.
  • The request timestamp drifted too far from the server clock.
  • The same nonce was reused.
Verify the credentials and the signing implementation. Sync the server clock with NTP. See the Authentication page for the full signing process.

​
403 Forbidden

The signature is valid, but the token does not grant access to the requested resource. Either the hotel is outside your scope, or the feature is not enabled for your account. Contact us if you expected access.

​
404 Not Found

The URL does not match any Best Price endpoint. The Reference lists every endpoint with its full path.

​
500 Internal Server Error and other 5xx codes

A 5xx response signals an issue on the D-EDGE side. The body is a plain HTML error page rather than JSON, so do not assume a structured payload when handling these errors. 5xx errors are usually transient. Retry with exponential backoff. If a 5xx persists, contact us.