The GoREST API provides a free sandbox environment for performing REST API and GraphQL testing for prototyping. Registerd users provide fake user data, but the responses are real.
\nThe audience for the [GoREST API](http://gorest.co.in) is developers who need an easy way to test REST API and GraphQL endpoints.
\nUsers are required to create an account.
\nA Token Bearer is not required to GET all general user information, but all other specific requests require a Token Bearer.
\nIf you encounter any errors while using the API, please use the Help button at the top of the main screen to read our knowledge base. If your question has not been answered, feel free to post a new question. We’ll do our best to resolve the issue as soon as possible. Please keep in mind that we are located in the India Standard Time Zone (IST).
\nIf you would like to contact us for any other reason, please use our contact form on the bottom of the main page.
\nThe GoREST API provides user profiles with user id, name, email, gender and status. You can perform CRUD operations on all users.
\n[Users Endpoint](http://gorest.co.in/public/v2/users)
\nThe following request are allowed for the Users Endpoint:
\nGET, POST, PUT, PATCH, DELETE
\nThe GoREST API provides posts with post id, user_id, title and body. You can perform CRUD operations on all posts.
\n[Posts Endpoint](http://gorest.co.in/public/v2/posts)
\nThe following request are allowed for the Posts Endpoint:
\nGET, POST, PUT, PATCH, DELETE
\nThe GoRest API returns HTTP status and error code messages.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"7428671","collectionId":"2df0a653-6366-4d81-b6cc-080cf487460b","publishedId":"2s9YJXaQxS","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-09-26T15:48:47.000Z"},"item":[{"name":"POST Request to Create User","id":"4859f2d0-b784-4dd6-a4af-9fc255dcee35","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This request retrievs all users using a generic GET request.
\n","urlObject":{"protocol":"https","path":["public","v2","users"],"host":["gorest","co","in"],"query":[],"variable":[]}},"response":[{"id":"75ec94a0-63c7-4691-b652-955de236db1a","name":"Example of GET Request to Retrieve All Users","originalRequest":{"method":"GET","header":[],"url":"https://gorest.co.in/public/v2/users"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 May 2023 01:57:08 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"etag","value":"W/\"ac22af499e69a66023390cb0438efb5d\""},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"vary","value":"Origin"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-download-options","value":"noopen"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-links-current","value":"https://gorest.co.in/public/v2/users?page=1"},{"key":"x-links-next","value":"https://gorest.co.in/public/v2/users?page=2"},{"key":"x-links-previous","value":""},{"key":"x-pagination-limit","value":"10"},{"key":"x-pagination-page","value":"1"},{"key":"x-pagination-pages","value":"297"},{"key":"x-pagination-total","value":"2964"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"x-request-id","value":"bcbd7cf2-d726-4f92-b337-42f1d3756842"},{"key":"x-runtime","value":"0.040418"},{"key":"x-xss-protection","value":"0"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=IF2kEYZwCmuDnIYK07XA5VzZ1SIAK6Qk9ReGU69SM3ep8lIbxtnHjJQnGwBklfpZPPg2tQSyDrseFO6qpX5RHXHDnnXucnOwbAwMFvxp8IT%2B7Uwqc5D2ub7CPFvbuyc%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7c046970df53828a-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 1313068,\n \"name\": \"Mr. Aaratrika Ahluwalia\",\n \"email\": \"mr_ahluwalia_aaratrika@renner-skiles.example\",\n \"gender\": \"female\",\n \"status\": \"inactive\"\n },\n {\n \"id\": 1313067,\n \"name\": \"Radha Ahuja\",\n \"email\": \"radha_ahuja@schuppe.test\",\n \"gender\": \"male\",\n \"status\": \"inactive\"\n },\n {\n \"id\": 1313065,\n \"name\": \"Tapan Kaniyar\",\n \"email\": \"kaniyar_tapan@bauch.example\",\n \"gender\": \"male\",\n \"status\": \"active\"\n },\n {\n \"id\": 1313064,\n \"name\": \"Aashritha Dubashi PhD\",\n \"email\": \"phd_aashritha_dubashi@marks.test\",\n \"gender\": \"female\",\n \"status\": \"inactive\"\n },\n {\n \"id\": 1313062,\n \"name\": \"Swapnil Bandopadhyay DDS\",\n \"email\": \"bandopadhyay_dds_swapnil@windler.test\",\n \"gender\": \"female\",\n \"status\": \"active\"\n },\n {\n \"id\": 1313061,\n \"name\": \"Sen. Navin Banerjee\",\n \"email\": \"banerjee_sen_navin@weber.example\",\n \"gender\": \"male\",\n \"status\": \"active\"\n },\n {\n \"id\": 1313060,\n \"name\": \"Bhramar Dubashi\",\n \"email\": \"bhramar_dubashi@cremin-oreilly.example\",\n \"gender\": \"male\",\n \"status\": \"active\"\n },\n {\n \"id\": 1313059,\n \"name\": \"Atmaja Shah\",\n \"email\": \"atmaja_shah@marks-romaguera.test\",\n \"gender\": \"male\",\n \"status\": \"inactive\"\n },\n {\n \"id\": 1313058,\n \"name\": \"Bankimchandra Kaul\",\n \"email\": \"bankimchandra_kaul@barrows.example\",\n \"gender\": \"male\",\n \"status\": \"active\"\n },\n {\n \"id\": 1313057,\n \"name\": \"Aaryan Banerjee\",\n \"email\": \"aaryan_banerjee@satterfield.test\",\n \"gender\": \"male\",\n \"status\": \"inactive\"\n }\n]"}],"_postman_id":"a3bfc403-7731-48f0-90cb-f8549616f3d4"},{"name":"GET Request to Retrieve User by ID","id":"d0da1420-cf9a-48a7-bb19-7d711be34285","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This request uses GET to retrieve the specific user by id.
\nRequired. The ID is generated automatically when a user is created. The ID is required for PUT and DELETE methods.
Note: You must use ID for GET method when requesting the user details with specific user ID.
This request uses GET to retrieve a specific user by email.
\nRequired. The email is used for creating a new user. The email is required for POST, PUT and PATCH.
\n","urlObject":{"protocol":"https","path":["public","v2","users"],"host":["gorest","co","in"],"query":[{"key":"email","value":"nicepeople@gmail.com"}],"variable":[]}},"response":[{"id":"fa07abac-1a52-4178-b5e8-baf22bf1ecb4","name":"Example of GET Request to Retrieve User by Email","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://gorest.co.in/public/v2/users?email=nicepeople@gmail.com","protocol":"https","host":["gorest","co","in"],"path":["public","v2","users"],"query":[{"key":"email","value":"nicepeople@gmail.com"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 May 2023 02:15:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"etag","value":"W/\"ed64b76bf200c7c180f869f7c5f518bf\""},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"vary","value":"Origin"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-download-options","value":"noopen"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-links-current","value":"https://gorest.co.in/public/v2/users?page=1"},{"key":"x-links-next","value":""},{"key":"x-links-previous","value":""},{"key":"x-pagination-limit","value":"10"},{"key":"x-pagination-page","value":"1"},{"key":"x-pagination-pages","value":"1"},{"key":"x-pagination-total","value":"1"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"x-ratelimit-limit","value":"90"},{"key":"x-ratelimit-remaining","value":"89"},{"key":"x-ratelimit-reset","value":"1"},{"key":"x-request-id","value":"ddbf2da3-0142-4cce-a8c5-5fcf7639c918"},{"key":"x-runtime","value":"0.107262"},{"key":"x-xss-protection","value":"0"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=qzs09IcdbPFWjE%2BaPWuSKMHl0hhsIXTain3kUf4UH3tcgCgvEQmhJpb5D6ZP1XGVbwKI9RoG1gMirhkhEG3k%2B2P%2FZImJ8InFPmYUO7nxeV9jdGrrQmhI6NYgwD4ckHU%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7c04840ded6d3903-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 1315901,\n \"name\": \"Nice People\",\n \"email\": \"nicepeople@gmail.com\",\n \"gender\": \"female\",\n \"status\": \"active\"\n }\n]"}],"_postman_id":"c8ca4db6-7421-4324-9858-aa7c409625de"},{"name":"PUT Request to Update Data","id":"d3f1c7a8-20e6-4b1c-ae5c-6446058c3826","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"You can use PUT method to modify the user details.
\nNote: ID value must be passed in the URL.
\nExample:
\nhttps://gorest.co.in/public/v2/users/
\nAll other parameters you want to modify can be passed in the Body as a JSON structure. Refer to the response example.
\n","urlObject":{"protocol":"https","path":["public","v2","users","1318190"],"host":["gorest","co","in"],"query":[{"disabled":true,"key":"id","value":"1318190"},{"disabled":true,"key":"name","value":"NicePeople3"}],"variable":[]}},"response":[{"id":"731c7753-2996-442b-8c90-5ce38d84e549","name":"Example of PUT Request to Update Data","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 1318190,\n \"name\": \"NicePeople4\",\n \"email\": \"nicepeople4@gmail.com\",\n \"gender\": \"female\",\n \"status\": \"active\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://gorest.co.in/public/v2/users/1318190","protocol":"https","host":["gorest","co","in"],"path":["public","v2","users","1318190"],"query":[{"key":"id","value":"1318190","disabled":true},{"key":"name","value":"NicePeople3","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 03 May 2023 17:10:43 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"etag","value":"W/\"b805c070552c7aeea8f88a3fdeb723a7\""},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"vary","value":"Origin"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-download-options","value":"noopen"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"x-ratelimit-limit","value":"90"},{"key":"x-ratelimit-remaining","value":"89"},{"key":"x-ratelimit-reset","value":"1"},{"key":"x-request-id","value":"7815f473-e99f-4346-9089-feeb434b0363"},{"key":"x-runtime","value":"0.122526"},{"key":"x-xss-protection","value":"0"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=8M5YVUB9ESYVzQ4QwIcKt1NNLYDwd2UubAZZZ6SPJ6BNfL7tGci0aTprpwDOzyuZmW2R6Kp8Pic%2BPAxC%2FnWrNgENrQycEPHIhvwuov%2B9wccbuRaubGxEBs79rIAMboQ%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7c1a1e724b9f3910-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"email\": \"nicepeople4@gmail.com\",\n \"name\": \"NicePeople4\",\n \"gender\": \"female\",\n \"status\": \"active\",\n \"id\": 1318190\n}"}],"_postman_id":"d3f1c7a8-20e6-4b1c-ae5c-6446058c3826"},{"name":"POST Request to Make a Post","id":"af1328d6-f811-4d56-b3e8-ebdaa601b46f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This request uses POST to make a post.
\n","urlObject":{"protocol":"https","path":["public","v2","posts"],"host":["gorest","co","in"],"query":[],"variable":[]}},"response":[{"id":"6cbfe1f8-a0b8-4641-a3a9-99b3f2199812","name":"Example of POST Request to Make a Post","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"user_id\": 1372024,\n \"title\": \"How to Have a Nice Day\",\n \"body\": \"Get at least 8 hours sleep to start.\"\n}","options":{"raw":{"language":"json"}}},"url":"https://gorest.co.in/public/v2/posts"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 03 May 2023 17:30:45 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"etag","value":"W/\"5601b9afcb0ddef0d45bd905c5a8cb12\""},{"key":"location","value":"https://gorest.co.in/public/v2/posts/18164"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"vary","value":"Origin"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-download-options","value":"noopen"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"x-ratelimit-limit","value":"90"},{"key":"x-ratelimit-remaining","value":"89"},{"key":"x-ratelimit-reset","value":"1"},{"key":"x-request-id","value":"a9c03d02-d0ac-4174-ad1a-0d67f328e5c8"},{"key":"x-runtime","value":"0.085344"},{"key":"x-xss-protection","value":"0"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=EuDNvWrowoznkeHkppjesH1bbAfUwKieJk9oar0YK6WiVBTj3SgCN2ecpR9m9wrNtCbg%2F8bd%2BfrZLP8DRx69DVvrYC67yDjUqx45DEqPAdaie5NhY2FZxTErBetDG9w%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7c1a3bd0ae4f82d4-IAD"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 18164,\n \"user_id\": 1372024,\n \"title\": \"How to Have a Nice Day\",\n \"body\": \"Get at least 8 hours sleep to start.\"\n}"}],"_postman_id":"af1328d6-f811-4d56-b3e8-ebdaa601b46f"},{"name":"PUT Request to Update a Post","id":"b74f2306-15ca-4c78-886e-110134fd697a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This reques uses PUT to update a post.
\n","urlObject":{"protocol":"https","path":["public","v2","posts","18164"],"host":["gorest","co","in"],"query":[],"variable":[]}},"response":[{"id":"97e5e5c0-b40e-4ebc-911c-cfbdc2e291fc","name":"Example of PUT Request to Update a Post","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"user_id\": 1372024,\n \"title\": \"How to Enjoy Each Day\",\n \"body\": \"Get at least 10 hours sleep to start.\"\n}","options":{"raw":{"language":"json"}}},"url":"https://gorest.co.in/public/v2/posts/18164"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 03 May 2023 17:55:29 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"etag","value":"W/\"6276da804b7daca366919ceb06a52000\""},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"vary","value":"Origin"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-download-options","value":"noopen"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"x-ratelimit-limit","value":"90"},{"key":"x-ratelimit-remaining","value":"89"},{"key":"x-ratelimit-reset","value":"1"},{"key":"x-request-id","value":"329a20b7-0616-43e4-a323-586c86112665"},{"key":"x-runtime","value":"0.085525"},{"key":"x-xss-protection","value":"0"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=vFcvD0q%2FQvYgyjAoSy6jM%2B8bN%2FugoNFrWMdJLbSdwcs4m%2FbnQyGp31DnEPqc1r9CJzyhx%2B3ffERLtVMvBIj3sbAjfRm5rhgvGQnzZujS71WVVTvPeHUHZAig963018w%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"7c1a600ccd522430-IAD"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"user_id\": 1372024,\n \"title\": \"How to Enjoy Each Day\",\n \"body\": \"Get at least 10 hours sleep to start.\",\n \"id\": 18164\n}"}],"_postman_id":"b74f2306-15ca-4c78-886e-110134fd697a"}]}