finished starring api, not yet tested.