---
title: "Distinct values for one custom field"
method: GET
path: "/v1/contacts/fields/{field}/values"
tags: ["Contacts"]
---

# Distinct values for one custom field

`GET /v1/contacts/fields/{field}/values`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/contacts/fields/{field}/values`
- Auth: HTTP bearer

The 100 most common values stored under one custom `data` key, most frequent first, each with a count.

Built for populating a segment-filter dropdown from real data instead of asking someone to remember what they wrote. Contacts that lack the key, or store null under it, are excluded — so the counts here total less than your contact count.

The cap is a fixed 100 and there is no pagination: a field with a longer tail than that is a free-text field, not a segment filter.

## Path parameters

- `field` string, required

## Response `200`

Distinct values with counts.

- object
  - `field` string
  - `data` object[]: Up to 100 distinct values, most common first.
    - `value` unknown
    - `count` integer

## Other responses

- `401`: Missing or invalid API key.
- `422`: Request validation failed (code `validation_error`, 422).

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)