---
title: "Retrieve Option Access Rights"
url: "https://earlyaccess.developers.bynder.com/apis/access-rights-and-options-api-1/versions/2cd9cb69-0956-4ff4-9774-4af770df8a45/paths/api-1-content-access-options-optionId/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/access-rights-and-options-api-1/versions/2cd9cb69-0956-4ff4-9774-4af770df8a45.md

# Retrieve Option Access Rights

`GET` `/api/1/content-access/options/{optionId}`

## Path parameters

- `optionId` (string, required) - Option ID

## Query parameters

- `principalId` (string, optional) - Principal ID
- `limit` (integer, optional) - Number of results to return
- `start` (string, optional) - Cursor for next page
- `before` (string, optional) - Cursor for previous page

## Responses

- `200` - Successful response
- `403` - Forbidden

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Access Rights and Options API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
    variables:
      your-bynder-domain:
        default: your-bynder-domainDefaultValue
  - url: https://DefaultParameterValue
    variables: {}
  - url: https://your-bynder-domainDefaultValue/v6/authentication/oauth2
    variables: {}
  - url: https://{your-auth-url}
    variables:
      your-auth-url:
        default: DefaultParameterValue
  - url: https://DefaultParameterValue
    variables: {}
  - url: https://your-bynder-domainDefaultValue/v6/authentication/oauth2
    variables: {}
paths:
  /api/1/content-access/options/{optionId}:
    get:
      parameters:
        - description: Option ID
          in: path
          name: optionId
          required: true
          schema:
            type: string
        - description: Principal ID
          in: query
          name: principalId
          required: false
          schema:
            type: string
        - description: Number of results to return
          in: query
          name: limit
          required: false
          schema:
            default: 20
            maximum: 1000
            minimum: 1
            type: integer
        - description: Cursor for next page
          in: query
          name: start
          required: false
          schema:
            type: string
        - description: Cursor for previous page
          in: query
          name: before
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  $ref: "#/components/schemas/ApiContentAccessMetapropertiesResponse"
                type: array
          description: Successful response
        "403":
          description: Forbidden
      summary: Retrieve Option Access Rights
      tags:
        - Options
security:
  - OAuth2: []
  - permanentToken: []
components:
  schemas:
    ApiContentAccessMetapropertiesResponse:
      properties:
        contentId:
          examples:
            - 00000000-0000-0000-0000-000000000000
          type: string
        contentType:
          examples:
            - metaproperty
          type: string
        id:
          examples:
            - 00000000-0000-0000-0000-000000000000
          type: string
        level:
          examples:
            - metaproperty.hide
          type: string
        principalExtraInformation:
          $ref: "#/components/schemas/PrincipalExtraInformation"
        principalId:
          examples:
            - 00000000-0000-0000-0000-000000000000
          type: string
        principalName:
          examples:
            - User full name
          type: string
        principalType:
          examples:
            - user
          type: string
        ruleType:
          examples:
            - allow
          type: string
      title: ApiContentAccessMetapropertiesResponse
      type: object
    PrincipalExtraInformation:
      properties:
        email:
          examples:
            - user_email@bynder.com
          type: string
      title: PrincipalExtraInformation
      type: object
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://DefaultParameterValue/
          scopes: {}
          tokenUrl: https://your-bynder-domainDefaultValue/v6/authentication/oauth2/token
        clientCredentials:
          scopes: {}
          tokenUrl: https://your-bynder-domainDefaultValue/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```