updated docs to match production API responses

Hi, the responses I was seeing from your API didn't match the docs, so I fixed the docs.