/ownership/initial-holdings

Anchored listing of initial beneficial-ownership filings (Form 3) and their holdings. Requires ticker (or cik) and/or insider_cik; unanchored queries belong to POST /screener/initial-holdings.

POST/api/v1/ownership/initial-holdings

Credits30 per pageRate limit120 per minute

Request:

tickerstring

Uppercased automatically.

cikstring

The company's CIK, instead of ticker. Digits only, ≤ 10; leading zeros optional.

insider_cikstring

Digits only, ≤ 10; leading zeros optional.

relationshipstring[]

Any of is_director, is_officer, is_ten_percent_owner, is_other. OR semantics, evaluated per filing.

Default omitted

no_securities_ownedbool

true → only filings that report no holdings; false → only filings with holdings; omitted → both.

Default omitted

include_unresolved_amendmentsbool

Default false

exclude_likely_mergedbool

Default false

include_anomaliesbool

Default false

pageint ≥ 1

Default 1

page_sizeint 1–100

Counts filings.

Default 50

detailstring

"light" leaves out each filing's footnotes and each holding's footnote_refs. See Response detail.

Default "full"

At least one of ticker / cik / insider_cik is required, and not both ticker and cik (422 otherwise).

Response:

page, page_size, has_more, next_page

Pagination.

anomalies_excluded_on_page

How many holdings on this page were withheld because they failed a consistency check. 0 when include_anomalies=true.

filings

Array. Each carries ticker, issuer, issuer_cik, accession_number, form_type, filing_date, period_of_report, date_of_original_submission, merge_status, remarks, no_securities_owned, source_url_prefix, insiders, footnotes, holdings, and amendments (present only when amendments were merged).

filings[].no_securities_owned

true when the filer reported holding no securities; such filings have an empty holdings array.

filings[].insiders

cik, name, is_director, is_officer, is_ten_percent_owner, is_other, officer_title, other_text.

filings[].footnotes

Map of footnote id → text for this filing.

_warnings

Optional.

credits_used

Always 30.

Credits: 30 per page.

Errors: 404 OWNERSHIP_COMPANY_NOT_FOUND (charged), 403 PLAN_TIER_INSUFFICIENT_COVERAGE when the company is outside your plan's coverage scope (charged), 422 VALIDATION_ERROR, 402 CREDITS_INSUFFICIENT.