Skip to main content
Handle errors by code; use message to explain the problem to the user.

Request errors

A failed HTTP request returns an error object containing code and message. Keep the X-Request-ID response header, when supplied, for troubleshooting. A successful GET returns HTTP 200 even when the saved search has status: "failed". Its top-level error explains why no supported records were returned. Poll only while status is running. A settled search with at least one supported record is completed without an error, including after a deadline or cancellation. Individual records have no error field. See Get a search for the lifecycle.