DB1: api documentation