documented the box low level api