api method must be supplied