← all problem types

invalid_range

422 Unprocessable Content   The requested time range is not valid.

When you get it

The requested time range is not valid. It is always answered with HTTP 422 - one code means one status, so a client may key its handling on either.

Fields it carries

Inside each errors[] entry, beside pointer:

parameter
The query parameter the failure is about - the query-side twin of `pointer`.
from
The start of the requested time range, Unix seconds.
to
The end of the requested time range, Unix seconds.
maxSpan
The widest time range this endpoint serves, in seconds.
suggestedBucket
A bucket granularity that would make the requested range fit.
reason
The machine-readable sub-case, when one code covers several. Branch on it.
value
The value the request sent, echoed back so the caller can see what was read.
min
The smallest value this field accepts, inclusive.
max
The largest value this field accepts, inclusive.
buckets
How many time buckets the requested window and bucket size produce over the requested range.
detail
Human-readable detail for this one occurrence. Never the only place remediation appears.

A field is omitted when the server genuinely does not know it - an absent member is never the same as an empty one.

How to fix it

The request was well-formed but a value is not acceptable. The fields above name the offending value and what would be accepted - fix the request and retry.

Shape

{
  "type":   "https://api2.host-tracker.com/problems/invalid-range",
  "title":  "The requested time range is not valid.",
  "status": 422,
  "code":   "invalid_range",
  "errors": [
    { "parameter": …, "from": …, "to": …, "maxSpan": …, "suggestedBucket": …, "reason": …, "value": …, "min": …, "max": …, "buckets": …, "detail": … }
  ]
}