---
title: "Retrieve metaproperties"
method: GET
path: "/api/1/taxonomy/metaproperties"
tags: ["Metaproperties - New API (Preferred)"]
---

# Retrieve metaproperties

`GET /api/1/taxonomy/metaproperties`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/1/taxonomy/metaproperties`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://{your-auth-url}`
    - Client credentials
    - Token URL: `https://{your-bynder-domain}/v6/authentication/oauth2/token` scopes: `METAPROPERTYMANAGEMENT`, `METAMANAGEMENT`
  - API key in header `Authorization`

Returns a paginated list of metaproperties.

The /api/1 endpoints are for management tasks. Your API token must include the write scope (`meta.assetbank:write`) to use these endpoints, also for read-only operations. These endpoints do not separate read access from write access.

## Query parameters

- `limit` integer
- `page` integer
- `ids` string[]
- `metapropertyTypes` string[]
- `autocomplete` boolean

## Response `200`

- object
  - `metadata` object, required
    - `nextPage` string, required
    - `totalCount` integer, required
  - `metaproperties` object[]
    - `allowDuplicates` boolean, required
    - `autocomplete` boolean, required
    - `createDuringApply` boolean, required
    - `definition` string
    - `id` string, required
    - `metapropertyType` 'single-select' | 'multi-select' | 'date' | 'text', required
    - `name` string, required

---

[API](https://skmtc.dev/bynder/apis/metaproperty.md) - [All operations](https://skmtc.dev/bynder/apis/metaproperty/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/metaproperty/revisions/be5714f3522e?raw)