---
title: "Retrieve options for a metaproperty"
method: GET
path: "/api/1/taxonomy/metaproperties/{metapropertyId}/options"
tags: ["Options - New API (Preferred)"]
---

# Retrieve options for a metaproperty

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

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/1/taxonomy/metaproperties/{metapropertyId}/options`
- 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`

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.

## Path parameters

- `metapropertyId` string, uuid, required

## Query parameters

- `start` string
- `before` string
- `limit` integer
- `externalReference` string
- `ids` string[]

## Response `200`

- object
  - `metadata` object, required
    - `nextPage` string
    - `prevPage` string
  - `options` object[]
    - `definition` string
    - `externalReference` string, required
    - `icon` string, required
    - `id` string, required
    - `name` string, required

## Other responses

- `400`
- `404`

---

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