[README][s]: update readme to document current response format.