Distinct values for one custom field
/v1/contacts/fields/{field}/valuesSecret key — sk_… or sk_test_… · Base URL https://api.volanea.com
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
fieldstringrequired
Response
Distinct values with counts.
fieldstringdataobject[]Up to 100 distinct values, most common first.
valueanycountinteger
Errors
Every failure returns the standard envelope — branch on `code`, never on the wording of `error`.
401Missing or invalid API key.422Request validation failed (code `validation_error`, 422).
Request
curl https://api.volanea.com/v1/contacts/fields/id_123/values \
-H "Authorization: Bearer sk_..."Response
200 · application/json
{
"success": true,
"data": {
"field": "<field>",
"data": [
{
"value": "<value>",
"count": 1
}
]
}
}92 endpoints · OpenAPI document