completed endpoints for client rest api