Quickstart: call the Credicorp public API from Node.js

List products

With a modern Node runtime you do not need axios or node-fetch — the global fetch is enough:

const BASE = 'https://api.credicorp.co.uk/public/v1';

async function listProducts() {
  const res = await fetch(`${BASE}/products`, {
    headers: { Accept: 'application/json' },
  });
  if (!res.ok) {
    const err = await res.json();
    throw new Error(`${res.status} ${err.error?.code}: ${err.error?.message}`);
  }
  const { data } = await res.json();
  return data;
}

listProducts().then(products => {
  for (const p of products) {
    console.log(`${p.name} — up to £${p.max_amount.toLocaleString()}`);
  }
});

Handle the error envelope

Every non-2xx response uses the same envelope, so one guard clause covers all of them. The example above reads err.error.code and err.error.message; the full shape is:

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Too many requests. Retry after the window resets.",
    "request_id": "req_1c9a"
  }
}

Branch on error.code (a stable machine string), never on the human-readable message.

Environment-driven base URL

Keep the host in an environment variable so the same build runs against sandbox and production:

const BASE = process.env.CREDICORP_BASE
  || 'https://sandbox.credicorp.co.uk/public/v1';

There are no secrets for the public ring, so this is the only configuration you need.