---
title: "How many contacts have this field set"
method: GET
path: "/v1/contacts/fields/{field}/usage"
tags: ["Contacts"]
---

# How many contacts have this field set

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

## Request

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

How many contacts have this custom field set to a non-null value.

Worth calling before `DELETE /v1/contacts/fields/{field}` — that endpoint is irreversible and project-wide, and this is the number it would affect.

## Path parameters

- `field` string, required

## Response `200`

Usage count.

- object
  - `field` string
  - `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)