added api method.