finished api methods