---
title: >-
  We're launching the AccessScope resource, which lets you query shops for your
  app's permissions - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/we-re-launching-the-accessscope-resource-which-lets-you-query-shops-for-your-app-s-permissions
  md: >-
    https://shopify.dev/changelog/we-re-launching-the-accessscope-resource-which-lets-you-query-shops-for-your-app-s-permissions.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2018-11-29T08:54:45-05:00'
  postedAt: '2018-02-26T00:00:00-05:00'
  updatedAt: '2024-02-02T10:04:52-05:00'
  effectiveAt: '2018-02-26T00:00:00-05:00'
---

February 26, 2018

Tags:

* API

# We're launching the AccessScope resource, which lets you query shops for your app's permissions

Today we're launching the new AccessScope resource, which allows you to query a merchant's shop for the list of permissions associated to your app. Using this functionality you can easily manage scopes across your various users' shops.

***

```
GET /admin/oauth/access_scopes.json

{
  "access_scopes": [
    {
      "handle": "read_products"
    },
    {
      "handle": "write_orders"
    }
  ]
}
```

Access scopes include permissions, such as `read_orders` and `write_products`, that allow apps to access data from a shop. The list of access scopes retrieved is based on the access token used for the request, and it contains only those access scopes that are granted to the token. For example, the list may contain all access scopes, or it may contain a subset if the access token has limited permissions. You can find the related documentation [here](https://help.shopify.com/en/api/reference/access/accessscope).