documented APIs