---
title: "Retrieve scopes"
url: "https://earlyaccess.developers.bynder.com/apis/o-auth-20-1/versions/09a25bc1-038b-40be-a677-10c314a6ec04/paths/v6-authentication-oauth2-scopes/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/o-auth-20-1/versions/09a25bc1-038b-40be-a677-10c314a6ec04.md

# Retrieve scopes

`GET` `/v6/authentication/oauth2/scopes`

Retrieve a JSON formatted overview of the existing scopes within Bynder and the required user permissions.

## Responses

- `200` - Successful response

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: OAuth 2.0
  version: 1.0.0
paths:
  /v6/authentication/oauth2/scopes:
    get:
      description: Retrieve a JSON formatted overview of the existing scopes within
        Bynder and the required user permissions.
      responses:
        "200":
          content:
            application/json:
              examples:
                example-1:
                  value:
                    groups:
                      - name: Group name
                        scopes:
                          - anyOfPermissions:
                              - scope.permission
                            description: Scope description
                            name: scope:action
              schema:
                properties:
                  groups:
                    items:
                      properties:
                        name:
                          example: Group name
                          type: string
                        scopes:
                          items:
                            properties:
                              anyOfPermissions:
                                items:
                                  example: scope.permission
                                  type: string
                                type: array
                              description:
                                example: Scope description
                                type: string
                              name:
                                example: scope:action
                                type: string
                            type: object
                          type: array
                      type: object
                    type: array
                type: object
          description: Successful response
      summary: Retrieve scopes
      tags:
        - Scopes
```