/api/v1/form-13f/fund/{cik}/periodsList all available report periods for a fund.
List all available report periods for a fund.
Why use this
Common use case
Returns the full list of quarter-end dates for which this fund has a parsed 13F-HR filing — the lookup endpoint that powers 'quarter-selector' dropdowns on fund-detail pages (e.g. WhaleWisdom-style 'Q4 2025 / Q3 2025 / Q2 2025 / ...' dropdown).
Use this BEFORE calling GET /api/v1/form-13f/fund/{cik} to discover which quarters are queryable — passing a non-existent period to that endpoint returns 404, so frontends typically render this list as the dropdown options. The latest_period convenience field is the default selection.
CIK input is normalized server-side (6/7/10-char zero-padding handled per Phase 47-era normalization). For finding a fund's CIK in the first place, see GET /api/v1/form-13f/filers (alias-aware autocomplete: buffett → Berkshire, ackman → Pershing, dalio → Bridgewater).
Parameters
| Name | In | Required | Default | Allowed | Description | Example |
|---|---|---|---|---|---|---|
| cik | path | required | — | — | Fund CIK (e.g. 0001067983) | 0000320193 |
Response schema
| Field | Type | Nullable | Description |
|---|---|---|---|
| cik | string | no | Fund CIK as a 10-character zero-padded string. Echoed back from the request — useful for asserting your client passed the CIK you intended after the server's CIK-padding normalization (handles 6/7/10-char input forms). |
| periods | array | no | Array of ISO `YYYY-MM-DD` quarter-end dates for which this fund has a parsed 13F-HR (or 13F-HR/A) filing in FinRadar's coverage. Sorted newest-first. Always calendar quarter ends (03-31, 06-30, 09-30, 12-31). Coverage starts ~2013-Q1 for active filers; older dates indicate longer-standing managers like Berkshire Hathaway (FinRadar's coverage start). Empty array when the CIK is registered but has never filed a 13F-HR. |
| periods[] | string | no | Single ISO `YYYY-MM-DD` reporting period end. 13F-HR is filed quarterly within 45 days of this date. Pass back as the `period` query param to [GET /api/v1/form-13f/fund/{cik}](/docs/institutional-holdings/form-13f-api/get-form-13f-fund-cik) to drill into that quarter's holdings. |
| latest_period | string | yes | Convenience pointer to `periods[0]` (the newest quarter). Null on empty array. Useful for quick 'latest filed quarter' lookups without indexing into the array client-side. |
| count | integer | no | Total number of distinct quarters in `periods[]`. Active large managers (Berkshire, Vanguard, BlackRock) have 50+ quarters going back to 2013; newer managers have lower counts. |
Sample response
- "cik": "0001067983"
- "periods":
- "2025-12-31"
- "2025-09-30"
- "2025-06-30"
- "2025-03-31"
- "2024-12-31"
- "latest_period": "2025-12-31"
- "count": 5
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/fund/{cik}/periods" \
-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).