just a single method to call the api - documentation revisited