/ownership/transactions

Anchored listing of insider-trade filings and their transactions. Requires ticker (or cik) and/or insider_cik; unanchored queries belong to POST /screener/ownership.

POST/api/v1/ownership/transactions

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.

transaction_codestring[]

≤ 20 entries. Unknown codes are dropped with a _warnings entry.

Default omitted

transaction_form_type"4" | "5"

Default omitted

relationshipstring[]

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

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 transaction'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 transactions 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, source_url_prefix, insiders, footnotes, transactions, and amendments (present only when amendments were merged).

filings[].issuer_cik

The issuer CIK declared by the filing itself. null when the filing does not provide issuer identity.

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.