[Reviewer: Ellie] Update API docs to cover specific numbers

Updates the Ellis API docs to cover the feature I added in https://github.com/Metaswitch/ellis/pull/61.

I've also deleted two parts where we described function we hadn't implemented - I thought this was confusing.
Can you make this consistent with the rest of the api doc - preferably by adding examples for the other calls