Update API docs with note about what offers are returned in the list.
Update API docs with notes about authorization scheme