Beta

List Business fields

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
GET
/v1/fields

Every public and paid Business field you can filter, search and show, that some Business has a value for: key, label, type, privacy, price (paid fields, per 1,000 values returned), the operators it takes and its List column. Use a key in search_businesses where and fields, in a List rule ({kind:"field",field:key,operator,value}) and its column in get_list_members fields or update_list view.data_columns. postgres_operators run everywhere; every other operator needs the fast reader (400 needs_fast_reader where it is off). With list_id, fields nobody on that List has a value for are left out too. Fields with no values yet are left out (hidden_count) and appear once they have some; they still work by key. Free; reads no Business.

Authorization

headerAuthorizationBearer <token>

A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.

Query Parameters

group?string

Only fields in this registry group.

Value in"franchise""brands-presence""value-readiness""signals""locations-geography""financials""lists""business-profile""community""market""ownership""legal-compliance"
list_id?string

Count fields among this List's Businesses instead of every Business: a field nobody on the List has a value for is left out.

Match^list_[0-7][0-9A-HJKMNP-TV-Z]{25}$
q?string

Words in a field's key or label, such as revenue.

Length1 <= length <= 100

Header Parameters

SMB-Workspace-Id*string
Formatuuid

Response Body

Successful authorized response.

application/json
  1. response
data*
request_id*string
curl -X GET 'https://example.com/v1/fields' \  -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08'
{  "data": {    "version": "smb.field-registry.v1",    "count": 0,    "hidden_count": 0,    "fields": [      {        "key": "string",        "label": "string",        "group": "string",        "type": "text",        "privacy": "public",        "estimated": true,        "price": {          "group": "string",          "usd_per_1000": 0,          "credit_units": 0        },        "operators": [          "eq"        ],        "postgres_operators": [          "eq"        ],        "column": "string",        "select": "string",        "choices": [          "string"        ],        "yes_only": true      }    ]  },  "request_id": "string"}