Java Quick Start

Get an API Key and Secret

If you haven’t already, sign up for a free trial.

Include the PasswordPing Library

The Java package is available either via package manager or direct download.


The passwordping-java-client is available in Maven Central. Just include the following in your pom.xml dependencies section.



Include the following in your build.gradle dependencies section.

dependencies {
  compile 'com.passwordping:passwordping-java-client:1.0.3'


You can download a version of the .jar directly from

Try Out Our Example Code

We’ve made calling the API dead simple. This sample code snippet shows you examples of calling the four supported APIs:

// Create a new PasswordPing instance - this is our primary interface for making API calls
PasswordPing passwordping = new PasswordPing(YOUR_API_KEY, YOUR_API_SECRET);
// Check whether a password has been compromised
if (passwordping.CheckPassword("password-to-test")) {
    System.out.println("Password is compromised");
else {
    System.out.println("Password is not compromised");
// Check whether a specific set of credentials are compromised
if (passwordping.CheckCredentials("", "password-to-test")) {
    System.out.println("Credentials are compromised");
else {
    System.out.println("Credentials are not compromised");
// get all exposures for a given user
ExposuresResponse exposures = passwordping.GetExposuresForUser("");
System.out.println(exposures.getCount() + " exposures found for");
// now get the full details for the first exposure found
ExposureDetails details = passwordping.GetExposureDetails(exposures.getExposures()[0]);
System.out.println("First exposure for was " + details.getTitle());

Learn More

That should get you started. Check out the Github project page for more details.