adding examples of using the api