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

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

# Retrieve metaproperties

`GET` `/api/v4/metaproperties`

## 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 each metaproperty. __Warning:__ Always ensure to remove the metaproperty options from the response when using this endpoint. Include the param `options=0` in every request sent.
- `ids` (string, optional) - Comma-separated list of metaproperty ids. Will return a metaproperty for each existing id.

## Responses

- `200` - Successful response

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Metaproperty
  version: "1.0"
servers:
  - url: https://{your-bynder-domain}
paths:
  /api/v4/metaproperties:
    get:
      parameters:
        - 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 each metaproperty. __Warning:__ Always
            ensure to remove the metaproperty options from the response when
            using this endpoint. Include the param `options=0` in every request
            sent.
          in: query
          name: options
          required: false
          schema:
            default: true
            type: boolean
        - description: Comma-separated list of metaproperty ids. Will return a
            metaproperty for each existing id.
          in: query
          name: ids
          required: false
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              examples:
                example-1:
                  value:
                    Bob_button:
                      id: 00000000-0000-0000-0000000000000001
                      isApiField: true
                      isDisplayField: false
                      isDrilldown: false
                      isEditable: true
                      isFilterable: true
                      isMainfilter: true
                      isMultifilter: false
                      isMultiselect: false
                      isRequired: false
                      label: Bob_button
                      name: Bob_button
                      showInDuplicateView: false
                      showInGridView: false
                      showInListView: true
                      type: button
                      useDependencies: false
                      zindex: 2
                    Colours:
                      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-0000000000000001
                          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
      summary: Retrieve metaproperties
      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
```