---
title: "Retrieve Metaproperty"
url: "https://earlyaccess.developers.bynder.com/apis/metaproperty-1/versions/e015c0a3-e9ae-46ee-9a70-047f982dcfe9/operations/getApi1TaxonomyMetapropertiesMetapropertyid"
---

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

# Retrieve Metaproperty

`GET` `/api/1/taxonomy/metaproperties/{metapropertyId}`

Operation ID: `getApi1TaxonomyMetapropertiesMetapropertyid`

Retrieve a single metaproperty by its id

## Path parameters

- `metapropertyId` (string, uuid, required)

## Responses

- `200`
- `404`

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Metaproperty
  version: "1.0"
servers:
  - url: https://{your-bynder-domain}
paths:
  /api/1/taxonomy/metaproperties/{metapropertyId}:
    get:
      description: Retrieve a single metaproperty by its id
      operationId: getApi1TaxonomyMetapropertiesMetapropertyid
      parameters:
        - in: path
          name: metapropertyId
          required: true
          schema:
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              examples:
                Metaproperty:
                  summary: Response containing the requested metaproperty
                  value:
                    allowDuplicates: false
                    autocomplete: false
                    createDuringApply: false
                    id: 00000000-0000-0000-0000-000000000000
                    metapropertyType: single-select
                    name: Example Metaproperty
              schema:
                properties:
                  allowDuplicates:
                    type: boolean
                  autocomplete:
                    type: boolean
                  createDuringApply:
                    type: boolean
                  definition:
                    type: string
                  id:
                    type: string
                  metapropertyType:
                    enum:
                      - single-select
                      - multi-select
                      - date
                      - text
                    title: MetapropertyTypeEnum
                    type: string
                  name:
                    type: string
                required:
                  - id
                  - name
                  - metapropertyType
                  - createDuringApply
                  - autocomplete
                  - allowDuplicates
                title: Metaproperty
                type: object
          description: ""
        "404":
          content:
            application/json:
              examples:
                MetapropertyNotExisting:
                  summary: Response when the metaproperty does not exist
                  value:
                    errorCode: metaproperty-not-existing
                    message: Metaproperty does not exist
              schema:
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                required:
                  - errorCode
                  - message
                title: MetapropertyNotExistingOutput
                type: object
          description: ""
      summary: Retrieve Metaproperty
      tags:
        - Metaproperties - New API (Preferred)
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
```