---
title: "List the filter fields available for a search source type"
method: GET
path: "/search/filters-mode/fields"
tags: ["search"]
---

# List the filter fields available for a search source type

`GET /search/filters-mode/fields`

Returns every filter field accepted by POST /search/filters-mode for the given source type, including each field's type, description, allowed values, and usage guidance. Call this before creating a search to build valid filters.

## Query parameters

- `source_type` 'people' | 'companies', required

## Response `200`

200

- SearchFieldsResponse
  - `fields` SearchFilterField[], required
    - `allowed_values` string[]
    - `description` string
    - `name` string, required
    - `type` string, required
  - `guidance` SearchFieldsGuidance, required
    - `behavior` string[], required
    - `create_examples` SearchCreateExample[]
      - `intent` string, required
      - `request` object, required
        - `filters` object, required
        - `source_type` 'people' | 'companies', required
    - `field_guidance` SearchGuidanceItem[], required
      - `fields` string[]
      - `id` string, required
      - `text` string, required
  - `source_type` 'people' | 'companies', required

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `429` — 429

---

[API](https://skmtc.dev/clay/apis/clay-public-api.md) · [All operations](https://skmtc.dev/clay/apis/clay-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clay/clay-public-api/revisions/04621d9c0274/schema)