updated docs to match return JSON