Quickstart: call the Creditcorp public API from

Q: Do I need OkHttp or Apache HttpClient?

No. The built-in HttpClient (Java 11+) covers every public-ring call. Add a third-party client only if your project already standardises on one.

Q: How do I handle errors in Java?

Check the status code and read the error object from the body — error.code is the stable machine string to branch on. The pattern is identical across every endpoint.

2 min read

JavaFirst call

timeoutBound every request

data[]Unwrap the envelope

List products

import java.net.http.*;
import java.net.URI;

var client = HttpClient.newHttpClient();
var req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.credicorp.co.uk/public/v1/products"))
    .header("Accept", "application/json")
    .timeout(java.time.Duration.ofSeconds(10))
    .build();
var res = client.send(req, HttpResponse.BodyHandlers.ofString());
if (res.statusCode() >= 400) throw new RuntimeException(res.body());
System.out.println(res.body());

Java 11+ ships java.net.http.HttpClient, so you can call the API with no third-party HTTP library. Decode the JSON with Jackson or Gson, and set a request timeout as shown.

Use the sandbox in development

Point the base host at https://sandbox.credicorp.co.uk/public/v1 in development and CI, and at https://api.credicorp.co.uk/public/v1 in production, driven by one environment variable. See choosing a base URL.

Next steps

From here, request a quote, submit an enquiry, and send applicants to apply. Handle errors with the shared error envelope.

Frequently asked questions

Do I need OkHttp or Apache HttpClient?

No. The built-in HttpClient (Java 11+) covers every public-ring call. Add a third-party client only if your project already standardises on one.

How do I handle errors in Java?

Check the status code and read the error object from the body — error.code is the stable machine string to branch on. The pattern is identical across every endpoint.