Skip to content

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

NameInTypeRequiredDefaultDescription
cusipquerystringyesNine characters of 0-9, A-Z, *, @, # (trimmed, upper-cased). Required.
periodquerydate (YYYY-MM-DD)yesThe report period, YYYY-MM-DD. Required.
put_callquerystringnoanyany, none (rows without an option), put, call. One of: any, none, put, call.
as_ofquerystringnoInclusive: 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).
limitqueryintegerno200Page size, 1..1000.
cursorquerystringnoOpaque cursor from a previous page's next_cursor.

Responses

StatusBodyDescription
200F13fHolderList (application/json)OK
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (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).
503Problem (application/problem+json)Database unavailable; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a F13fHolderList object.

FieldTypeRequiredDescription
as_ofstring | nullno
cusipstringno
dataarray of F13fHolding + objectno
excludedExcludedno
excluded_totalintegerno
has_morebooleanno
limitsF13fLimitsno
next_cursorstring | nullno
perioddate (YYYY-MM-DD)no

Example request

Shell
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