desired api format for 0.1