# 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"}]}
```