---
title: "List Properties"
method: GET
path: "/v1/properties"
tags: ["properties"]
---

# List Properties

`GET /v1/properties`

List properties for your account.

## Query parameters

- `limit` integer
- `page_token` string
- `resource_type` 'donation' | 'deposit' — The API resource that the property is associated with.

## Response `200`

The response for Properties.list

- object
  - `results` Property[]
    - `id` string, required — The unique identifier for the property.
    - `name` string, required — The name of the property.
    - `resource_type` 'donation' | 'deposit', required — The API resource that the property is associated with.
    - `property_type` 'text' | 'enum' | 'user' | 'boolean' | 'date', required — The data type of a property.
    - `options` PropertyOptionValue[] — The first 25 options for enum and user properties. Use the [List Property Options](/api-reference/properties/list-options) endpoint to paginate through all options.
      - `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.
    - `total_option_count` integer — The total number of options for enum and user properties. When this is greater than the length of `options`, use the [List Property Options](/api-reference/properties/list-options) endpoint to paginate through all options.
  - `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
- `500` — Internal Server Error

---

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