Reference

GET /public/v1/loyalty/tiers

The loyalty tier ladder: the tier vocabulary, thresholds, headline benefits and cooldown — single-sourced so marketing and your integration read identical figures.

2 min read

GETHTTP method

NoneAuth

publicRing

Endpoint

Method	`GET`
Path	`/public/v1/loyalty/tiers`
Ring	public (unauthenticated, cacheable)

Parameters

None. Returns the tier ladder vocabulary.

Response

A JSON object describing the loyalty ladder: each tier's name, the threshold to reach it, its headline benefit and any cooldown. It carries vocabulary and figures only — no actor, no PII, no money — so it is safe to cache. The marketing pages read this exact endpoint so the tier config is single-sourced across the estate. Agents can read the same via the MCP tool loyalty_tiers.

Errors

A 429 on rate-limit; otherwise 200. See the public error table.

Frequently asked questions

Does this endpoint return a customer's own tier?

No. It is public vocabulary — the ladder, thresholds and benefits — with no customer data. A customer's own tier is behind authentication in the borrower portal, not on the public ring.

Can I cache the tier ladder?

Yes. It contains only config vocabulary and thresholds, so it is explicitly cacheable. Read it periodically rather than hard-coding the ladder so a config change flows through.