/api/v1/form-13f/filersSearch or list all 13F filers by fund name, CIK, manager name, or well-known alias, with filing counts, last-filed dates, and authorized signer.
Search or list all 13F filers by fund name, CIK, manager name, or well-known alias, with filing counts, last-filed dates, and authorized signer.
10 tokensSince v1.0.0
Why use this
Find any institutional filer across the full 13F universe (8,500+ filers). Searchable by fund name, CIK, manager/signer name (signature_name), AND a curated filer_aliases database table that maps well-known fund managers to their fund CIKs. For example, searching 'buffett' finds Berkshire Hathaway, 'ackman' finds Pershing Square, 'dalio' finds Bridgewater, etc. Returns filing counts, last filed date, reporting period, and authorized signer name. Supports limit up to 10,000 for client-side preloading. Aliases can be managed via the admin API at /api/v1/admin/filer-aliases.
Common use case
Building an autocomplete search box like StockCircle where typing 'Warren Buffett' or just 'buffett' finds Berkshire Hathaway via the filer_aliases table, or typing 'Bridgewater' finds the fund by company name. Use limit=10000 to preload all filers for instant client-side search.
Searches the universe of 13F filers (~9,600 institutional investment managers) by name or CIK. Use this to look up CIKs before drilling into POST /api/v1/form-13f/holdings (which requires a CIK). Returns the most recent filing date so you can see whether the filer is currently active.
Parameters
| Name | In | Required | Default | Allowed | Description | Example |
|---|---|---|---|---|---|---|
| q | query | optional | — | — | Free-text search across (1) fund/registrant name, (2) CIK (exact-match), (3) signature_name (the authorized signer on the most recent 13F filing — useful for finding 'who manages this fund'), AND (4) the curated `filer_aliases` table that maps well-known fund managers to their fund CIKs (e.g. `buffett` → Berkshire Hathaway, `ackman` → Pershing Square, `dalio` → Bridgewater, `burry` → Scion Asset Management). Case-insensitive. Omit `q` to list top filers by `filing_count` (descending). | buffett |
| limit | query | optional | 20 | — | Maximum filers returned (up to 10,000). The 10K cap supports client-side preloading the full filer universe for instant in-browser autocomplete (StockCircle-style UX). For typical query-driven autocomplete, 20-50 is plenty; for full-list preload use 10000. | 20 |
Response schema
| Field | Type | Nullable | Description |
|---|---|---|---|
| filers | array | no | Array of matching 13F filers, sorted by `filing_count DESC` (most-active filers first) — alias matches are boosted to the top. Empty array on no match. Use `cik` from this response as input to `POST /api/v1/form-13f/holdings` and `POST /api/v1/form-13f/cover-pages`. |
| filers[].cik | string | no | Filer CIK as a 10-character zero-padded string. The stable join key for this filer across the entire 13F surface (`/holdings`, `/cover-pages`, `/aggregation/by-ticker`, `/fund-performance`). Berkshire Hathaway is `0001067983`; Bridgewater is `0001350694`. |
| filers[].name | string | no | Registrant name AS FILED on the most recent 13F (typically all-caps in EDGAR convention, e.g. `BERKSHIRE HATHAWAY INC`). NOT alias-normalized — for the user-friendly alias (e.g. 'Warren Buffett') consult the `filer_aliases` admin table. Casing preserved verbatim. |
| filers[].latest_filed_at | string | yes | ISO-8601 UTC timestamp of the filer's most recent 13F filing. Null when the filer has registered but never filed. Use to detect inactive/dissolved filers — values older than ~7 months indicate the filer skipped the most recent quarterly deadline (45 days post-quarter-end). |
| filers[].filing_count | integer | no | Total cumulative 13F filings ingested for this filer (across all quarters and amendments). Active large managers (Berkshire, Vanguard, BlackRock) have 90-100+ filings going back to 2013 (FinRadar's coverage start); newer managers have lower counts. |
| filers[].latest_aum_usd | number | yes | Latest reported assets-under-management in USD, derived from the most recent 13F's aggregate position value (sum of `value` column post-thousands-correction). Null when the filer's holdings have not yet been re-aggregated by the `sec_13f_summary` matview (~6h refresh cadence post-filing). Berkshire AUM is typically $300-400B; mid-tier hedge funds $1-10B; family offices $50M-1B. |
| meta | object | no | Result metadata block: `{ total: integer, limit: integer }`. `total` reflects the full match count (not just the page); `limit` echoes the effective limit after server-side capping at 10000. |
Sample response
·
- "filers":
- "meta":
- "total": 1
- "limit": 100
Errors
| Status | Label | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 400 | Bad Request | Invalid query, body, or path parameter. |
| 401 | Unauthorized | Missing or invalid Authorization header / api_Token. |
| 402 | Payment Required | Insufficient token balance for this call. Top up |
| 429 | Too Many Requests | Rate limit exceeded for your tier (see /pricing for tier limits). Tier limits |
| 500 | Server Error | Unexpected server-side failure. Retry with backoff; report if persistent. |
Code samples
curl "https://api.finradar.ai/api/v1/form-13f/filers?api_Token=YOUR_API_KEY" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"Generate an API key in /account/credentials to run live queries (literal YOUR_API_KEY placeholder shown until then).