full api + documentation