interface for api methods