GET /v3/ownership/institutional/holders
The effective 13F rows of one CUSIP across managers for one period (as known at as_of), ordered by manager CIK, ledger step and row; options are their own rows. Matched against the normalised CUSIP as filed; no total. Rows of deleted (SEC-withdrawn) filings are left out; those filings are named in excluded.
API key: required. See Authentication.
Group: Institutional holdings (Form 13F)
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
cusip | query | string | yes | Nine characters of 0-9, A-Z, *, @, # (trimmed, upper-cased). Required. | |
period | query | date (YYYY-MM-DD) | yes | The report period, YYYY-MM-DD. Required. | |
put_call | query | string | no | any | any, none (rows without an option), put, call. One of: any, none, put, call. |
as_of | query | string | no | Inclusive: YYYY-MM-DDTHH:MM:SSZ (UTC, through the end of that second), YYYY-MM-DDTHH:MM:SS.ffffffZ (exact, 1-6 fraction digits) or YYYY-MM-DD (the whole UTC day). | |
limit | query | integer | no | 200 | Page size, 1..1000. |
cursor | query | string | no | Opaque cursor from a previous page's next_cursor. |
Responses
| Status | Body | Description |
|---|---|---|
200 | F13fHolderList (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | Problem (application/problem+json) | Missing, invalid or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728). |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a F13fHolderList object.
| Field | Type | Required | Description |
|---|---|---|---|
as_of | string | null | no | |
cusip | string | no | |
data | array of F13fHolding + object | no | |
excluded | Excluded | no | |
excluded_total | integer | no | |
has_more | boolean | no | |
limits | F13fLimits | no | |
next_cursor | string | null | no | |
period | date (YYYY-MM-DD) | no |
Example request
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/ownership/institutional/holders'Open this route in the console
More in Institutional holdings (Form 13F)
Previous: GET /v3/filings/{accession}/13f/holdings · Next: GET /v3/ownership/institutional/managers/{cik}/holdings
Markdown version: /docs/reference/get-ownership-institutional-holders.md