Errors

The API uses standard HTTP status codes and JSON error bodies.

Common errors

ParameterTypeRequiredDefaultDescription
400HTTPNo-Missing or invalid query parameters, for example missing `q` or invalid coordinates.
404HTTPNo-Resource not found on detail endpoints.
429HTTPNo-Rate limit exceeded.

Example

json
{
  "error": "Missing q parameter"
}

Rate limit example

json
{
  "error": "rate_limited",
  "message": "Too many requests",
  "retryAfterSeconds": 60
}