List contact fields
Lists core contact columns and custom field definitions under { data, pagination }. Use the field names in audience filters, contact search, and {{ field | fallback }} merge tags. Add ?include=coverage to decorate each row with fill stats — the % of contacts holding a non-empty value plus the most common values (sampled; approximate: true on large populations) — and optionally audienceId to scope those stats to one saved audience. Check coverage before personalizing on a field so most recipients see a real value, not the fallback.
Authorizations
Send your Brew API key as Authorization: Bearer brew_xxx.
Headers
The brand this request acts on. REQUIRED for organization-scoped credentials (otherwise 400 BRAND_ID_REQUIRED — there is no default brand); list ids with GET /v1/brands. Brand-scoped credentials may omit it, and sending a different brand returns 403 BRAND_SCOPE_MISMATCH. A brand outside your organization returns 404 BRAND_NOT_FOUND.
1 - 64Query Parameters
Opt-in expansion: coverage adds per-field fill stats (percent of contacts with a non-empty value + top values).
coverage Scope include=coverage stats to one saved audience (404 AUDIENCE_NOT_FOUND on an unknown / cross-brand id). Ignored without the include.
1 - 64Page size (1–100). Defaults to 100.
1 <= x <= 100Opaque pagination cursor echoed from the previous page’s pagination.cursor. Omit for the first page.
1 - 512