/api/v1/form-13f/filing-statsGet 13F filing statistics and calendar timeline: funds filed, % reported, deadline status, AUM, and key dates for the 13F filing calendar.
Get 13F filing statistics and calendar timeline: funds filed, % reported, deadline status, AUM, and key dates for the 13F filing calendar.
Why use this
Common use case
13F filing statistics + full filing-calendar timeline — the headline endpoint for 'Key Metrics' / 'Filing Calendar' dashboard panels. Powers the FinRadar surface most-similar to WhaleWisdom's filing-tracker widget with added calendar context (previous + last-complete + next-reporting periods + days-until-next-deadline countdown).
Smart default selection: when called WITHOUT ?period=, returns the most relevant quarter based on current date — the active filing period during filing season (within 45 days post-quarter-end), OR the last completed quarter when between filing seasons. This 'just-do-the-right-thing' default makes the endpoint trivial to consume from a homepage Key Metrics tile (no client-side date logic needed).
For a more rigorous filing-completeness signal that uses the recurring-filer baseline (CIK intersection of last TWO completed quarters — robust against net-new-registrant noise), see GET /api/v1/form-13f/filing-progress. For the live activity feed of the most recent filings, see GET /api/v1/form-13f/latest.
Note the unusual non-ApiResponse envelope shape — data is the only top-level key (no status, no request_id, no timestamp). This is preserved for backwards compatibility with existing dashboard consumers; future hardening will migrate to the canonical ApiResponse.success() envelope. All monetary values in USD (post-Plan-51 thousands correction).
Parameters
| Name | In | Required | Default | Allowed | Description | Example |
|---|---|---|---|---|---|---|
| period | query | optional | — | — | Quarter-end date (YYYY-MM-DD), e.g. 2025-12-31 for Q4 2025. Defaults to the last completed quarter when between filing seasons, or the current filing period during active filing season. | 2025Q4 |
Response schema
| Field | Type | Nullable | Description |
|---|---|---|---|
| data.period | string | no | ISO `YYYY-MM-DD` reporting quarter — always a calendar quarter end (03-31, 06-30, 09-30, 12-31). Echoed from request; defaults to the last completed quarter (between seasons) or the current filing period (during filing season). |
| data.deadline | string | no | ISO `YYYY-MM-DD` SEC 45-day filing deadline for `period`. Computed as `period + 45 days`, rolled to the next business day if the deadline falls on a weekend / federal holiday. The 4 standard 13F deadlines fall around mid-Feb, mid-May, mid-Aug, mid-Nov. |
| data.deadlineStatus | string | no | One of `upcoming` (deadline > today, filing season is ACTIVE), `today` (deadline == today, last-day rush), `past` (deadline < today, filing season COMPLETE for this quarter). Use to gate UI banners ('Filing season ends Feb 14, 22 days remaining' vs 'Q4 2025 filing complete'). |
| data.totalFundsFiled | integer | no | Number of distinct CIKs that have filed a 13F-HR (or 13F-NT) for `period`. Note this can EXCEED `previousQuarterFilers` (yielding `percentOfFundsReported > 100`) when net-new filers register or returning-from-hiatus filers report. Q4 2025 example: 8,381 funds filed against 8,010 prior-quarter baseline = 104.6%. |
| data.percentOfFundsReported | number | no | `totalFundsFiled / previousQuarterFilers * 100`. Values ~100% during normal filing seasons; >100% when net-new registrants outpace dropouts; <100% during early filing season (still accumulating). The headline filing-progress metric. |
| data.previousQuarterFilers | integer | no | Baseline count = number of distinct CIKs that filed a 13F-HR for the PRIOR quarter (`period - 3 months`). Used as the denominator for `percentOfFundsReported`. NOT the same as the recurring-filer baseline (CIK intersection of LAST TWO quarters) used by [GET /api/v1/form-13f/filing-progress](/docs/institutional-holdings/filing-progress-tracking/get-form-13f-filing-progress) — this endpoint uses the simpler single-quarter baseline. |
| data.totalFilings | integer | no | Total number of 13F filings for the period — includes ORIGINAL 13F-HRs, AMENDMENTS (13F-HR/A), and 13F-NT (notice-of-no-information) filings. Slightly higher than `totalFundsFiled` because some funds amend their original filings within the same quarter. |
| data.totalAUM | number | no | Aggregate AUM observed so far this quarter, in USD. Sum of `value_usd` across all parsed 13F-HR filings for the period (post-Plan-51 thousands correction). Q4 2025 example: $46.0T total — this is roughly the entire US institutional equity market. |
| data.lateNoticeFilers | integer | no | Number of CIKs that filed a 13F-NT (notice that no information table is forthcoming, typically because all positions are reported on another related 13F). Late-notice filers are usually subadvisors / parent-fund relationships — not 'late' in a regulatory sense. |
| data.previousPeriod | string | no | ISO `YYYY-MM-DD` end-date of the prior quarter (`period - 3 months`). Always a calendar quarter end. Useful for QoQ comparison UI (rendering 'Q3 2025 vs Q4 2025' header). |
| data.previousDeadline | string | no | ISO `YYYY-MM-DD` SEC deadline for the previous quarter. Same 45-day-rolling-to-business-day computation as `deadline`. |
| data.lastCompleteQuarterEnd | string | no | ISO `YYYY-MM-DD` end-date of the most recent COMPLETED quarter — i.e. the most recent quarter where the SEC filing deadline has passed. Use for 'show me the last fully-reported quarter' selectors. |
| data.beforeLastCompleteQuarterEnd | string | no | ISO `YYYY-MM-DD` end-date of the quarter before `lastCompleteQuarterEnd` — useful as the comparison baseline for 'this quarter vs prior quarter' charts that need to sidestep an in-progress filing season. |
| data.nextReportingPeriodStart | string | no | ISO `YYYY-MM-DD` start-date of the next reporting period — i.e. the day AFTER the current quarter ends. Useful for forward-looking calendar UI ('Next 13F filing period starts Apr 1'). |
| data.nextDeadline | string | no | ISO `YYYY-MM-DD` SEC deadline for the next reporting period. The next time institutional managers will collectively flood EDGAR with filings. |
| data.daysUntilNextDeadline | integer | no | `nextDeadline - today` in days. Render as a countdown ('86 days until Q1 2026 13F deadline'). Counts business days when within 2 weeks of the deadline; calendar days otherwise — see source for the exact computation rule. |
Sample response
- "data":
- "period": "2025-12-31"
- "deadline": "2026-02-17"
- "deadlineStatus": "past"
- "totalFundsFiled": 8381
- "percentOfFundsReported": 104.6
- "previousQuarterFilers": 8010
- "totalFilings": 8460
- "totalAUM": 46015643574871
- "lateNoticeFilers": 105
- "previousPeriod": "2025-09-30"
- "previousDeadline": "2026-02-17"
- "lastCompleteQuarterEnd": "2025-12-31"
- "beforeLastCompleteQuarterEnd": "2025-09-30"
- "nextReportingPeriodStart": "2026-04-01"
- "nextDeadline": "2026-05-15"
- "daysUntilNextDeadline": 86
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/filing-stats" \
-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).