simpler endpoint definitions; documentation on api homepage