---
title: "Retrieve security profiles"
url: "https://earlyaccess.developers.bynder.com/apis/security-roles-1/versions/b3488685-ac81-4a41-9298-71b99f882ca6/paths/api-v4-profiles/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/security-roles-1/versions/b3488685-ac81-4a41-9298-71b99f882ca6.md

# Retrieve security profiles

`GET` `/api/v4/profiles/`

To determine the security profile for your user you can compare the security profile id with the profileId retrieved from either the Retrieve specific user or Retrieve current user call. It’s the API’s responsibility to enforce that users can only perform allowed actions but nevertheless we recommend that your application checks whether or not an action can be performed because this will create a better user experience.

## Responses

- `200` - Successful response
- `401` - Invalid or expired token

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Security Roles
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/profiles/:
    get:
      description: >
        To determine the security profile for your user you can compare the
        security profile id with the profileId retrieved from either the
        Retrieve specific user or Retrieve current user call. It’s the API’s
        responsibility to enforce that users can only perform allowed actions
        but nevertheless we recommend that your application checks whether or
        not an action can be performed because this will create a better user
        experience.
      responses:
        "200":
          content:
            application/json:
              example: |
                [
                  {
                    "name": "Admin",
                    "id": "1",
                    "roles": [
                      "GROUPMANAGEMENT",
                      "USERMANAGEMENT",
                      "PERMISSIONMANAGEMENT"
                    ]
                  },
                  {
                    "name": "User",
                    "id": "2",
                    "roles": [
                      "USERMANAGEMENT"
                    ]
                  }
                ]
              schema:
                items:
                  properties:
                    id:
                      type: string
                    name:
                      type: string
                    roles:
                      items:
                        type: string
                      type: array
                  type: object
                type: array
          description: Successful response
        "401":
          content:
            text/plain:
              example: |
                Invalid or expired token.
              schema:
                type: string
          description: Invalid or expired token
      security:
        - permanentToken:
            - PERMISSIONMANAGEMENT
        - OAuth2:
            - PERMISSIONMANAGEMENT
      summary: Retrieve security profiles
      tags:
        - Profiles
security:
  - permanentToken:
      - PERMISSIONMANAGEMENT
  - OAuth2:
      - PERMISSIONMANAGEMENT
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            PERMISSIONMANAGEMENT: Grants permission to manage permissions
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            PERMISSIONMANAGEMENT: Grants permission to manage permissions
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```