added api method + tests
minor