hbb api ref simplified