Error codes

Every refusal the API makes is an RFC 9457 problem, sent as application/problem+json. Branch on its code, which never changes; the error sentence is for people and can. Its type is the URL of the code's page below, and its request_id is the one to quote when you contact us.

Some answers come from the platform or our edge itself, before the API sees the request, as plain JSON with an error member and no code, type or X-Request-Id: 503 platform_standby to a write during a failover; at launch, once the origin lock enforces, 403 edge_auth_required to a request that didn't pass through our edge; and 503 service_unavailable, below, to any request during an outage. When there is no code, branch on error.

HTTP 503
content-type: application/json
retry-after: 60
cache-control: public, max-age=10
x-robots-tag: noindex, nofollow, noarchive

{
  "error": "service_unavailable",
  "retryAfter": 60,
  "message": "Our upstream provider is experiencing an outage. The site will be back online as soon as service is restored. If urgent, please visit https://secondappraisal.com/ to reveal contact details."
}