Recipe

Make your first public-API call

Your first call to the Credicorp public API takes about a minute and needs no credentials. Read the loyalty ladder with a single GET, inspect the JSON, and you have proven the ring works. This recipe walks the whole loop: the request, the response, and what to do if you hit the rate limit.

2 min read

1 minTo first response

no keyPublic ring

GETSimplest endpoint

Step 1 — call a read endpoint

The loyalty-tiers endpoint is the friendliest first call: a plain GET, no body, no auth.

curl -sS https://hub.credicorp.co.uk/public/v1/loyalty/tiers

Step 2 — read the response

You get a 200 with the four tiers in Bronze→Platinum order, each carrying its thresholds and arrangement-fee discount (in percent units), plus a generated timestamp. See the full reference for the field-by-field shape.

Step 3 — handle the rate limit

The public ring allows 60 requests per 60 seconds per IP. If you loop this call in a tight script you will eventually get a 429 with a Retry-After header — sleep for that many seconds and retry. See Rate limits and 429.