---
title: "List properties"
method: GET
path: "/accounts/{account_id}/custom_metadata/properties"
tags: ["Custom Metadata"]
---

# List properties

`GET /accounts/{account_id}/custom_metadata/properties`

List all custom metadata properties for an account.

This endpoint is only available to accounts with advanced plans or above.

## Path parameters

- `account_id` string, required

## Query parameters

- `data_type` 'boolean' | 'date' | 'link' | 'multi_select' | 'number' | 'single_select' | 'string' | 'text' — data type of the property
- `project_id` string
- `page` integer
- `per_page` integer
- `q` string
- `sort` string
- `order` string

## Headers

- `X-PhraseApp-OTP` string

## Response `200`

OK

- CustomMetadataProperty[]
  - `id` string
  - `name` string
  - `description` string
  - `data_type` 'boolean' | 'date' | 'link' | 'multi_select' | 'number' | 'single_select' | 'string' | 'text' — data type of the property
  - `user` UserPreview
    - `id` string
    - `username` string
    - `name` string
    - `gravatar_uid` string
  - `projects` ProjectShort[]
    - `id` string
    - `name` string
    - `main_format` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `value_options` string[]
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400` — Bad request. The request could not be parsed or a parameter failed validation. Verify the request body, the content type, and the parameter types, then retry.
- `404` — Not found. The requested resource does not exist or is not visible to the authenticated user. Verify the identifiers in the request path and that the token has access to them, then retry.
- `429` — Too many requests. The rate limit has been exceeded. Wait until the time indicated by the `X-Rate-Limit-Reset` response header before retrying.

---

[API](https://skmtc.net/phrase/apis/control-hub-service.md) · [All operations](https://skmtc.net/phrase/apis/control-hub-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phrase/control-hub-service/revisions/98ecac7ba2bf/schema)