Documented API calls' return format.

This is in response to issue #108.

:ghost: :jack_o_lantern: :ghost: 
I think (a) this is usually a number, rather than a string, and (b) zero is an unlikey value.