---
title: "List Property Options"
method: GET
path: "/v1/properties/{id}/options"
tags: ["properties"]
---

# List Property Options

`GET /v1/properties/{id}/options`

List all options for an enum or user property.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `page_token` string

## Response `200`

The response for Properties.listOptions

- object
  - `results` PropertyOptionValue[]
    - `id` string, required — The unique identifier for the property value.
    - `name` string, required — The human readable string for the property value.
    - `description` string — A description of the property option.
  - `next_page_token` string — A cursor token to use to retrieve the next page of results by making another API call to the same endpoint with the same parameters (only changing the pageToken). If specified, then more results exist on the server that were not returned, otherwise no more results exist on the server.

## Other responses

- `400` — The request is invalid or contains invalid parameters
- `401` — Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403` — Access denied
- `404` — Resource Not Found
- `500` — Internal Server Error

## Changes

- **2026-06-29** `b87f7738d336` — 10 breaking, 25 info
  - removed the required property `code` from the response with the `400` status
  - removed the required property `code` from the response with the `401` status
  - removed the required property `code` from the response with the `403` status
  - removed the required property `code` from the response with the `404` status
  - …31 more
- **2026-06-29** `c65f43c5ad90` — 5 warning
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `401` status
  - removed the optional property `details` from the response with the `403` status
  - removed the optional property `details` from the response with the `404` status
  - …1 more
- **2026-06-25** `f89b4f376e94` — 15 info
  - added the optional property `details/items/debug` to the response with the `400` status
  - added the optional property `details/items/debug` to the response with the `401` status
  - added the optional property `details/items/debug` to the response with the `403` status
  - added the optional property `details/items/debug` to the response with the `404` status
  - …11 more
- …earlier changes not shown

[Full history](https://skmtc.dev/chariot-giving/apis/specs/changes/v1/properties/:id/options/get.md)

---

[API](https://skmtc.dev/chariot-giving/apis/specs.md) · [All operations](https://skmtc.dev/chariot-giving/apis/specs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chariot-giving/specs/revisions/6f769ddf43bd/schema)