# List Business fields (/docs/api-reference/list_fields)

`GET /v1/fields` · operation `list_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.

**Sign-in:** a signed-in person's access token (`Authorization: Bearer …`), which AI apps get through MCP sign-in; or a Workspace API key in the `X-SMB-API-Key` header.

### Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `group` | one of `franchise`, `brands-presence`, `value-readiness`, `signals`, `locations-geography`, `financials`, `lists`, `business-profile`, `community`, `market`, `ownership`, `legal-compliance` | no | Only fields in this registry group. |
| `list_id` | string | no | Count fields among this List's Businesses instead of every Business: a field nobody on the List has a value for is left out. |
| `q` | string | no | Words in a field's key or label, such as revenue. |

### Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `SMB-Workspace-Id` | string (uuid) | yes |  |

### Response

**200** Successful authorized response.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object | yes |  |
| `data.version` | `smb.field-registry.v1` | yes |  |
| `data.count` | integer | yes |  |
| `data.hidden_count` | integer | no | Fields left out of this answer because no Business (on the List, with list_id) has a value for them yet. They come back by themselves, and still work when asked for by key. |
| `data.fields` | array of object | yes |  |
| `request_id` | string | yes |  |

### Errors

- `400` The request is invalid.
- `401` Authentication is required.
- `403` The caller is not authorized.
- `404` The resource was not found.
- `409` The resource revision or idempotency input conflicts.
- `413` The request body is too large.
- `415` The request must be JSON.
- `422` Required evidence is missing.
- `429` Rate limit reached; honor Retry-After.
- `500` The request could not be completed.
- `502` A dependency returned an invalid response.
- `503` The service is temporarily unavailable.

### Example

```bash
curl --request GET "https://api.smb.co/v1/fields" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "SMB-Workspace-Id: $WORKSPACE_ID"
```