# List contact field definitions

**GET** `/contacts/custom-fields`

Returns the reusable custom fields that can store structured customer context on
contacts, such as lifecycle stage, preferred store, or renewal date.

Authentication: bearerAuth
Required scopes: `custom_field:list`
Allowed roles: `owner`, `admin`, `agent`
Authorization: List contact field definitions.

## Responses

- `200`: Contact field definitions
- `default`: Error