whit added some code to api, as well as some documentation and todo's