Update README.md

Add description of paginated household details call; reduce scehma output to sample only.