Reference

Public API error reference

The error model for the /public/v1 ring: status families, the JSON error body, the 422 range errors on quotes, the 429 rate-limit error and which are retryable.

2 min read

GETHTTP method
NoneAuth
publicRing

Endpoint

MethodGET
Path/public/v1/*
Ringpublic (error model)

Parameters

Not applicable — this page documents the shared error shape returned by every public endpoint.

Response

StatusCode familyMeaningRetry?
400bad_requestMalformed requestNo
422out_of_range / validatione.g. quote amount/term outside boundsNo — clamp input
404not_foundUnknown pathNo
429rate_limitedExceeded 60 req/60s per IPYes — after the window
5xxserver_errorTransient hub faultYes — back off

The JSON body carries a machine code and a human message; branch on the code. See errors and retries.

Errors

Every error is JSON with a stable code. The most common on the public ring are the 422 range errors from quote and the 429 rate-limit.

Frequently asked questions

What is the most common public-ring error?

The 422 out-of-range error on the quote endpoint (amount outside £50–£500 or term outside 14–84 days) and the 429 rate-limit. Both are avoidable — clamp inputs and respect the 60 req/60s window.

Should I branch on the message text?

No. Branch on the machine code, which is stable. The human message may be reworded and should only be surfaced to people, not parsed by code.

Funding for UK limited companies

Credicorp lends to your company, not to you personally — short-term working capital with no personal guarantee. See what your business could access.