---
title: "List Custom Properties"
method: GET
path: "/custom_properties"
tags: ["Custom Property"]
---

# List Custom Properties

`GET /custom_properties`

Returns all custom properties for the organization.
Results are paginated using cursor-based pagination.
Supports filtering by workspace and type.

## Query parameters

- `workspace_id` string, uuid — The unique identifier for a resource.
- `type` 'text' | 'list'
- `limit` integer
- `after` string

## Response `200`

OK

- CustomPropertyList
  - `data` CustomProperty[], required — List of custom properties.
    - `id` string, uuid, required — ID of the Custom Property.
    - `name` string, required — Name of the Custom Property.
    - `type` 'text' | 'list', required — Type of the Custom Property.
    - `value` string, required — Text value for text properties.
    - `value_ids` string[], required — Array of option ids for list properties.
    - `values` string[], required — Array of option values for list properties.
  - `next_cursor` string, nullable — Cursor for the next page. Null if no more pages available.

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `405` — This method is not allowed
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/revisions/8d258c0b45d6/schema)