Add API module to docs

Include example usage of the class
Combine param names to prevent it being seen as param type
Rename id to number for clarity