PROPOSAL - add missing example requests

There is a lot of inconsistency around example code in our documentation. This change will ensure that all requests have an example and the wording/formatting is consistent.

- [x] @HelenRoss 
- [x] @antfrew 
- [x] kate
- [x] @joelr