Skip to content

GET /v3/ownership/insiders/transactions

Forms 3/4/5 transaction rows (Table I and Table II) across filings, newest filing first, then table and row. Each row carries its filing, issuer, every reporting owner and its footnotes; rows belong to the filing and are never repeated per owner. view=as_filed lists every filed row; view=effective (provisional) applies the amendments row by row: a row an amendment restated is replaced by the amendment's row, rows of an amendment that could not be matched unambiguously stay as filed with the flag amendment_unreconciled, and every row of a chain names its original and its amending filing. as_of: only filings SEC had accepted by then. Without issuer_cik, owner_cik or code, filed_from and filed_to are required and at most 31 days apart. Deleted (SEC-withdrawn) filings: listed by view=as_filed (filing.status deleted) unless status leaves them out; left out of view=effective (a deleted amendment does not amend) and named in excluded.

API key: required. See Authentication.

Group: Insider ownership (Forms 3, 4, 5)

Parameters

NameInTypeRequiredDefaultDescription
issuer_cikquerystringnoIssuer CIK, padded or unpadded.
owner_cikquerystringnoReporting owner CIK, padded or unpadded (any owner of the filing).
codequerycomma-separated list of stringnoTransaction codes (P, S, A, M, F, G, ...), comma-separated or repeated.
tablequerystringnoallall, non_derivative (Table I) or derivative (Table II). One of: all, non_derivative, derivative.
filed_fromquerydate (YYYY-MM-DD)noFirst filing date (inclusive), YYYY-MM-DD.
filed_toquerydate (YYYY-MM-DD)noLast filing date (inclusive), YYYY-MM-DD.
viewquerystringnoas_filedas_filed or effective (provisional). One of: as_filed, effective.
statusquerycomma-separated list of stringnoWith view=as_filed, status(es) of the rows' filings: provisional, final, deleted, comma-separated (as GET /v3/filings). Default: every status, deleted (SEC-withdrawn) filings included; status=final,provisional leaves them out. With view=effective it is a 400: the effective view always leaves deleted filings out and names them in excluded.
footnote_containsquerystringnoOnly rows with a footnote whose text contains this, case-insensitive (3 to 200 characters; % and _ are plain characters). Needs issuer_cik, owner_cik, or filed_from and filed_to at most 31 days apart.
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).
limitqueryintegerno100Page size, 1..500.
cursorquerystringnoOpaque cursor from a previous page's next_cursor; bound to the filters (as_of included).

Responses

StatusBodyDescription
200InsiderRowList (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 InsiderRowList object.

FieldTypeRequiredDescription
as_ofstring | nullno
dataarray of InsiderRow + objectno
excludedExcludednoview=effective only.
excluded_totalintegernoview=effective only.
has_morebooleanno
next_cursorstring | nullno
provisionalbooleannoTrue for view=effective: the row-level amendment view is provisional.
viewstringnoOne of: as_filed, effective.

Example request

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/ownership/insiders/transactions'

Open this route in the console

More in Insider ownership (Forms 3, 4, 5)

Previous: GET /v3/ownership/insiders/holdings

Markdown version: /docs/reference/get-ownership-insiders-transactions.md