> ## Documentation Index
> Fetch the complete documentation index at: https://docs.askalchemist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Filter Options

> GET /api/documents/filters — return all valid source_name values.

## `GET /api/documents/filters`

Returns all `source_name` values currently in the Alchemist database.

Call this before using the `source_name` filter in `POST /api/insights/search` or `GET /api/documents` — source name matching is case-insensitive partial match, and this endpoint shows exactly what names are available.

### Authentication

`X-API-Key: alch_YOUR_KEY`

### No parameters

This endpoint takes no query parameters.

### Response `200`

```json theme={null}
{
  "source_names": [
    "Federal Reserve",
    "USDA",
    "Bureau of Labor Statistics",
    "Bureau of Economic Analysis",
    "U.S. Energy Information Administration",
    "SEC EDGAR",
    "Congressional Budget Office"
  ]
}
```

The list reflects what's currently in the database and will grow as Alchemist ingests new sources.

### Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.askalchemist.com/api/documents/filters \
    -H "X-API-Key: alch_YOUR_KEY"
  ```

  ```python Python theme={null}
  import httpx

  resp = httpx.get(
      "https://api.askalchemist.com/api/documents/filters",
      headers={"X-API-Key": "alch_YOUR_KEY"},
  )
  print(resp.json()["source_names"])
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch("https://api.askalchemist.com/api/documents/filters", {
    headers: { "X-API-Key": "alch_YOUR_KEY" },
  });
  const { source_names } = await res.json();
  ```
</CodeGroup>

### Usage pattern

```python theme={null}
import httpx

# 1. Get available sources
filters = httpx.get(
    "https://api.askalchemist.com/api/documents/filters",
    headers={"X-API-Key": "alch_YOUR_KEY"},
).json()["source_names"]

# 2. Pick the one that matches your intent
fed_source = next(s for s in filters if "Federal Reserve" in s)

# 3. Pass it as a filter
results = httpx.post(
    "https://api.askalchemist.com/api/insights/search",
    headers={"X-API-Key": "alch_YOUR_KEY"},
    json={"query": "rate path 2026", "source_name": fed_source},
).json()
```