Clarify response values in docs

[bachya]

Describe what the PR does:

SSIA

Does this fix a specific issue?

N/A

Checklist:

• Confirm that one or more new tests are written for the new functionality.
• Run tests and ensure everything passes (with 100% test coverage).
• Update README.md with any new documentation.

[codeclimate]

Code Climate has analyzed commit db64a2e and detected 0 issues on this pull request.

View more on Code Climate.

[codecov]

Codecov Report

Merging #253 (db64a2e) into dev (536168e) will not change coverage.
Report is 1 commits behind head on dev.
The diff coverage is n/a.

@@            Coverage Diff            @@
##               dev      #253   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           16        16           
  Lines          353       353           
=========================================
  Hits           353       353