---
title: "Retrieve metaproperty"
url: "https://earlyaccess.developers.bynder.com/apis/metaproperty-1/versions/e015c0a3-e9ae-46ee-9a70-047f982dcfe9/paths/api-v4-metaproperties-id/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/metaproperty-1/versions/e015c0a3-e9ae-46ee-9a70-047f982dcfe9.md

# Retrieve metaproperty

`GET` `/api/v4/metaproperties/{id}`

## Path parameters

- `id` (string, required) - Metaproperty id.

## Query parameters

- `count` (boolean, optional) - Indicates whether or not the response should include asset count results for metaproperty-options.
- `type` (string, optional) - Comma-separated list of asset types. Filters the count results by asset type.
- `options` (boolean, optional) - Indicates whether or not the response should include the metaproperty options of the metaproperty.

## Responses

- `200` - Successful response
- `404` - Metaproperty not found

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Metaproperty
  version: "1.0"
servers:
  - url: https://{your-bynder-domain}
paths:
  /api/v4/metaproperties/{id}:
    get:
      parameters:
        - description: Metaproperty id.
          in: path
          name: id
          required: true
          schema:
            type: string
        - description: Indicates whether or not the response should include asset count
            results for metaproperty-options.
          in: query
          name: count
          required: false
          schema:
            default: false
            type: boolean
        - description: Comma-separated list of asset types. Filters the count results by
            asset type.
          in: query
          name: type
          required: false
          schema:
            enum:
              - image
              - document
              - audio
              - video
              - 3d
            type: string
        - description: Indicates whether or not the response should include the
            metaproperty options of the metaproperty.
          in: query
          name: options
          required: false
          schema:
            default: true
            type: boolean
      responses:
        "200":
          content:
            application/json:
              examples:
                example-1:
                  value:
                    id: 00000000-0000-0000-0000000000000000
                    isApiField: true
                    isDisplayField: false
                    isDrilldown: false
                    isEditable: true
                    isFilterable: true
                    isMainfilter: true
                    isMultifilter: false
                    isMultiselect: false
                    isRequired: false
                    label: Colours
                    name: colours
                    options:
                      - active: true
                        date: February, 15 2017 14:54:58 +0000
                        description: ""
                        descriptions: {}
                        displayLabel: Yellow
                        hideByDefault: false
                        id: 00000000-0000-0000-0000000000000000
                        image: ___URL_TO_BYNDER_CDN___
                        isSelectable: true
                        label: Yellow
                        labels:
                          en_US: Yellow
                          nl_NL: Geel
                        linkedOptionIds: []
                        name: yellow
                        pregeneratedZipFileSize: 0
                        product_suffix: ""
                        zindex: 1
                      - active: true
                        date: February, 15 2017 15:50:55 +0000
                        description: ""
                        descriptions: {}
                        displayLabel: Red
                        hideByDefault: false
                        id: 00000000-0000-0000-0000000000000000
                        image: ___URL_TO_BYNDER_CDN___
                        isSelectable: true
                        label: Red
                        labels:
                          en_US: Red
                          nl_NL: Rood
                        linkedOptionIds: []
                        name: red
                        pregeneratedZipFileSize: 0
                        product_suffix: ""
                        zindex: 1
                    showInDuplicateView: false
                    showInGridView: false
                    showInListView: true
                    type: sidebar
                    useDependencies: false
                    zindex: 16
          description: Successful response
        "404":
          content:
            application/json:
              examples:
                example-1:
                  value:
                    message: Metaproperty not found
                    statuscode: 404
          description: Metaproperty not found
      summary: Retrieve metaproperty
      tags:
        - Metaproperties - Old API (Please use new API if possible)
security:
  - OAuth2:
      - METAPROPERTYMANAGEMENT
      - METAMANAGEMENT
  - permanentToken:
      - METAPROPERTYMANAGEMENT
      - METAMANAGEMENT
components:
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            METAMANAGEMENT: ""
            METAPROPERTYMANAGEMENT: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            METAMANAGEMENT: ""
            METAPROPERTYMANAGEMENT: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```