Recipe

Smoke-test the public API in 60 seconds

Q: Do I need to install anything?

No — just curl (or any HTTP client). The public ring needs no token, no SDK and no account, so a smoke test is three plain GET requests.

Q: What if healthz returns 503?

The hub is not currently ready — it fails closed rather than serving stale state, typically during a migration. Wait and retry; do not treat 503 as your integration being broken.

Confirm the public ring works before you build: three unauthenticated curls — healthz, products, quote — prove reachability, the catalogue and the quote engine in under a minute.

2 min read

3 callsNo token

< 60sEnd to end

curlNothing to install

1. Is the ring up?

curl -s https://hub.credicorp.co.uk/public/v1/healthz

A 200 confirms the hub is serving. A 503 means it is not ready (it fails closed on migration drift) — see healthz.

2. What products exist?

curl -s https://hub.credicorp.co.uk/public/v1/products

You should see Business Loan, Credicorp Flex and Credicorp Slice with their enabled flags — the products endpoint.

3. Does the quote engine answer?

curl -s 'https://hub.credicorp.co.uk/public/v1/quote/onetime?amount=300&term=30&frequency=weekly'

A £300 / 30-day quote lands within range (£50–£500, 14–84 days). Try amount=1000 to see the 422 range error. If all three succeed, you are ready to build — start with a quote widget or the MCP server.

Frequently asked questions

Do I need to install anything?

No — just curl (or any HTTP client). The public ring needs no token, no SDK and no account, so a smoke test is three plain GET requests.

What if healthz returns 503?

The hub is not currently ready — it fails closed rather than serving stale state, typically during a migration. Wait and retry; do not treat 503 as your integration being broken.