convert the response object to an array
revise readme