Quickstart: use the Creditcorp public API in

2 min read

Spring BootIdiomatic integration

cacheCatalogue changes rarely

configBase URL from env

Call the API from Spring Boot

@Service
public class CredicorpClient {
  private final RestClient client = RestClient.builder()
      .baseUrl("https://api.credicorp.co.uk/public/v1").build();

  public List<Product> products() {
    return client.get().uri("/products")
        .retrieve()
        .body(ProductList.class).data();
  }
}

Use the modern RestClient (Spring 6.1+) with a configured base URL, map responses to records, and cache with @Cacheable so the catalogue is fetched rarely.

Sandbox first

Set the base URL to https://sandbox.credicorp.co.uk/public/v1 in development and CI. See choosing a base URL.

Next steps

Add a quote form or an enquiry submission, and send applicants to apply. Handle failures with the shared error envelope.

Frequently asked questions

Should I cache the catalogue in Spring Boot?

Yes — it changes infrequently. Cache it for the response's max-age using Spring Boot's caching layer, so the API stays off your hot path and under the rate limit.

Where does the base URL belong?

In Spring Boot's configuration, read from an environment variable per environment, so the same build runs against sandbox and production by changing one value.