Added thorough endpoint and @todo rundown at top of API Docs