routed api methods