---
title: "List contact properties"
method: GET
path: "/v1/contacts/properties"
tags: ["Contact properties"]
---

# List contact properties

`GET /v1/contacts/properties`

Retrieve a list of your account's contact properties.<br>Use the `list` parameter to query "all" or "custom" properties.

## Query parameters

- `list` string

## Response `200`

Successful.

- ContactProperty[]
  - `key` string, required — The key of the contact property.
  - `label` string, required — The human-friendly label for this property.
  - `type` 'string' | 'number' | 'boolean' | 'date', required — The type of property.

## Other responses

- `405` — Wrong HTTP request method.

## Changes

> 9 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-07-21** `df77516a130a` — 4 warning
  - added the new `boolean` enum value to the `items/type` response property for the response status `200`
  - added the new `date` enum value to the `items/type` response property for the response status `200`
  - added the new `number` enum value to the `items/type` response property for the response status `200`
  - added the new `string` enum value to the `items/type` response property for the response status `200`

[Change history](https://skmtc.dev/loops/apis/loops-openapi-spec/changes/v1/contacts/properties/get.md)

---

[API](https://skmtc.dev/loops/apis/loops-openapi-spec.md) · [All operations](https://skmtc.dev/loops/apis/loops-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loops/loops-openapi-spec/revisions/8bd0098300ec/schema)