added API docs from Andres