add report endpoint, added some parameter comments (still much to do here so)