---
title: "List all organization contact fields available to the organization"
method: GET
path: "/contacts/fields"
tags: ["Contact Fields"]
---

# List all organization contact fields available to the organization

`GET /contacts/fields`

## Request

- Base URL: `https://api.sprucehealth.com/v1`
- URL: `https://api.sprucehealth.com/v1/contacts/fields`
- Auth: HTTP bearer

This operation lists all organization contact fields. These fields appear on all contacts in the interface.

## Query parameters

- `pageSize` integer
- `paginationToken` string: Token given in a previous response to allow requesting the next page

## Response `200`

Expected response to a valid request

- object
  - `fields` ContactOrganizationContactFieldName[], required: Field names declared by the organization that can be applied to a contact
    - `id` string, required: Spruce's contact organization contact custom field ID
    - `name` string, required: A name for the field
  - `hasMore` boolean, required
  - `paginationToken` string: Token given in a previous response to allow requesting the next page
  - `totalCount` integer, required

## Other responses

- `400`: bad request
- `500`: unexpected error

---

[API](https://skmtc.dev/sprucehealth/apis/spruce-health-api.md) - [All operations](https://skmtc.dev/sprucehealth/apis/spruce-health-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sprucehealth/apis/spruce-health-api/revisions/06e7a37de1ce?raw)
