more complete rest api