---
title: "Discover companies across filings"
method: GET
path: "/filing-discovery"
---

# Discover companies across filings

`GET /filing-discovery`

## Request

- Base URL: `https://boothcheck.com/api/v1`
- URL: `https://boothcheck.com/api/v1/filing-discovery`
- Auth: HTTP bearer

Cross-universe semantic vector search over companies' latest indexed annual filings, identical to Discover across filings on the Research page. Use it for questions such as which companies disclose China demand exposure, a particular supply constraint, or a named risk. It ranks issuers by their best matching filing passage and returns the SEC citation; it is discovery, not an exhaustive absence test. Requires a signed-in Founding Access account API key (Authorization: Bearer bck_...).

## Query parameters

- `query` string, required
- `format` 'json' | 'csv'

## Response `200`

Structured result. Every payload carries an informational-purposes disclaimer; no Boothcheck house fair value, price target, or rating.

## Other responses

- `401`: Missing or invalid API key for a keyed endpoint.
- `404`: Ticker not covered or no data for this surface.
- `429`: Rate limit reached for the key tier.

---

[API](https://skmtc.dev/boothcheck/apis/boothcheck-api.md) · [All operations](https://skmtc.dev/boothcheck/apis/boothcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/boothcheck/apis/boothcheck-api/revisions/fa7f52df2e65?raw)
