Java client library for Kill Bill
Java Shell


Java client library for Kill Bill.

Kill Bill compatibility

Client version Kill Bill version
0.23.y 0.16.z
0.40.y 0.18.z


The library is published in Maven Central:


The easiest way to get started is to look at some of our integration tests, which use this library.

When sending a body, if you are unsure which parameters to pass, take a look at the source code, which self-documents the required fields per call using preconditions.

Regarding error handling, if the server returns an error (400, 401, 409, 500, etc.), the code will throw KillBillClientException. If there is no response (204) or if an object cannot be found (404), the code will return null (for single objects) or an empty list (for collections of objects). Otherwise, you should never get null.


To build the library:

mvn clean install

This will produce several jars:

  • killbill-client-java-x.y.z-SNAPSHOT.jar which contains only the library
  • killbill-client-java-x.y.z-SNAPSHOT-jar-with-dependencies.jar which is a self contained jar (library and dependencies)