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

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

# Retrieve metaproperties

`GET` `/api/1/taxonomy/metaproperties`

Operation ID: `getApi1TaxonomyMetaproperties`

Returns a paginated list of metaproperties.

## Query parameters

- `limit` (integer, int32, optional)
- `page` (integer, int32, optional)
- `ids` (array, optional)
- `metapropertyTypes` (array, optional)
- `autocomplete` (boolean, optional)

## Responses

- `200`

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Metaproperty
  version: "1.0"
servers:
  - url: https://{your-bynder-domain}
paths:
  /api/1/taxonomy/metaproperties:
    get:
      description: Returns a paginated list of metaproperties.
      operationId: getApi1TaxonomyMetaproperties
      parameters:
        - in: query
          name: limit
          required: false
          schema:
            default: 20
            example: 250
            format: int32
            maximum: 1000
            type: integer
        - in: query
          name: page
          required: false
          schema:
            default: 1
            example: 1
            format: int32
            type: integer
        - in: query
          name: ids
          required: false
          schema:
            items:
              format: uuid
              type: string
            type: array
        - in: query
          name: metapropertyTypes
          required: false
          schema:
            items:
              enum:
                - single-select
                - multi-select
                - date
                - text
              title: MetapropertyTypeEnum
              type: string
            type: array
        - in: query
          name: autocomplete
          required: false
          schema:
            type: boolean
      responses:
        "200":
          content:
            application/json:
              examples:
                PaginatedMetapropertiesResponse:
                  summary: Response containing a paginated list of metaproperties
                  value:
                    metadata:
                      nextPage: ""
                      totalCount: 1
                    metaproperties:
                      - allowDuplicates: false
                        autocomplete: false
                        createDuringApply: false
                        id: 00000000-0000-0000-0000-000000000000
                        metapropertyType: single-select
                        name: Example Metaproperty
              schema:
                properties:
                  metadata:
                    properties:
                      nextPage:
                        type: string
                      totalCount:
                        format: int64
                        type: integer
                    required:
                      - nextPage
                      - totalCount
                    title: PaginationMetadata
                    type: object
                  metaproperties:
                    items:
                      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
                    type: array
                required:
                  - metadata
                title: PaginatedMetapropertiesResponse
                type: object
          description: ""
      summary: Retrieve metaproperties
      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
```