This is placeholder for documenting json API as delivered in #50 . Not sure where the best place would be - ideally in both source code, wiki and README.