# AccessScope <p>The AccessScope resource allows you to retrieve the permissions that a merchant has granted to an app, such as <code>read_orders</code> and <code>write_products</code>. These permissions allow apps to access data from a shop, and are granted when a merchant installs the app or updates an existing installation of the app.</p> <p>The list of access scopes retrieved is based on the access token for the request. It returns only those access scopes that are associated with the token.</p> <p>For more information about access scopes, see the <a href="https://shopify.dev/api/usage/access-scopes">access scopes API reference</a>.</p> <div class="note"> <h4>Note</h4> <p>If your app is already installed on a shop and you want the merchant to grant additional access scopes, you need to redirect the merchant to the app install page with the additional requested scopes. After a merchant installs the updated app, any subsequent calls made to the AccessScope resource will return the updated list of granted access scopes.</p> </div> ## Resource Properties ### AccessScope * access_scopes: The list of access scopes associated with the access token. * Type: x-string * Example: [{"handle"=>"write_product_listings"}, {"handle"=>"read_shipping"}] ## Get a list of access scopes Retrieves a list of access scopes associated with the access token. ### Endpoint /admin/oauth/access_scopes.json (GET) ### Responses #### 200 Get a list of access scopes Examples: ##### List all scopes Request: ``` GET /admin/oauth/access_scopes.json ``` Response: ``` HTTP/1.1 200 OK {"access_scopes":[{"handle":"read_products"},{"handle":"write_orders"},{"handle":"read_orders"}]} ```