We actually just rolled out a new version of our API last week, and put a _significant_ amount of effort into improving the documentation. Check it out: https://docs.balancedpayments.com/1.1/overview/