Beneficial ownership

Ownership rows, reference dates, and five-percent holder counts from DEF 14A filings.

Category: Company
Forms: DEF 14A

Use cases#

Identify disclosed holders and their reported ownership measurements.
Anchor ownership analysis to the filing reference date.

Response schema#

Fields 56

Field path	Type	Description
`reference_date`# required	object	As-of date the ownership snapshot is measured on, with its evidence.
`reference_date.value`# required	string\| null	ISO 8601 date; partial forms allowed. Never infer components absent from the source; null when not disclosed.
`reference_date.evidence`# required	object	Evidence object. Never null.
`reference_date.evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`reference_date.evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`five_percent_holder_count`# required	object	How many holders the source designates as 5%-or-greater beneficial owners.
`five_percent_holder_count.value`# required	integer\| null	Count of source-designated 5% holder rows. null when no such row family exists.
`five_percent_holder_count.evidence`# required	object	Evidence object. Never null.
`five_percent_holder_count.evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`five_percent_holder_count.evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`ownership_rows`# required	array\| null items: object	Ownership Rows
`ownership_rows[].name`# required	string\| null	Name
`ownership_rows[].investor_type`# required	string\| null	Investor Type
`ownership_rows[].company_role`# required	string\| null	Company role or source ownership label, as printed (director, NEO, 5% stockholder, management group).
`ownership_rows[].shareholdings`# required	array\| null items: object	null for a printed row whose current-ownership cells are all dashes.
`ownership_rows[].shareholdings[].share_class`# required	string\| null	Broad canonical class (`Common Stock`, `Preferred Stock`).
`ownership_rows[].shareholdings[].security_label`# required	string\| null	Source-derived qualifier for the class (`Class B`, `STRC Stock`). null when none.
`ownership_rows[].shareholdings[].shares_owned`# required	object	Printed beneficial ownership total for this class in the holder's row.
`ownership_rows[].shareholdings[].shares_owned.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].shareholdings[].shares_owned.unit`# required	string	Unit
`ownership_rows[].shareholdings[].percent_of_class`# required	object	A percentage. `unit` is always `"percent"`.
`ownership_rows[].shareholdings[].percent_of_class.value`# required	number\| null	Value
`ownership_rows[].shareholdings[].percent_of_class.unit`# required	string	Unit
`ownership_rows[].shareholdings[].components`# required	array\| null items: object	Components
`ownership_rows[].shareholdings[].components[].component_label`# required	string\| null	Source table column or footnote label, verbatim. Two components of one holder must not read alike while the source separates those lots — carry the separating words (named trustee, holder of record, series, beneficiary) into each label.
`ownership_rows[].shareholdings[].components[].holding_form`# required	string\| null	Normalized instrument/source or ownership form. null when unclear.
`ownership_rows[].shareholdings[].components[].is_beneficial_ownership`# required	boolean\| null	Whether this piece counts toward beneficial ownership. null when uncertain.
`ownership_rows[].shareholdings[].components[].shares_owned`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].shareholdings[].components[].shares_owned.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].shareholdings[].components[].shares_owned.unit`# required	string	Unit
`ownership_rows[].shareholdings[].components[].evidence`# required	object	Evidence object. Never null.
`ownership_rows[].shareholdings[].components[].evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`ownership_rows[].shareholdings[].components[].evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`ownership_rows[].total_voting_power_percent`# required	object	A percentage. `unit` is always `"percent"`.
`ownership_rows[].total_voting_power_percent.value`# required	number\| null	Value
`ownership_rows[].total_voting_power_percent.unit`# required	string	Unit
`ownership_rows[].voting_power`# required	object	Row-level sole/shared power over the shares. Never inferred by subtraction.
`ownership_rows[].voting_power.sole`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].voting_power.sole.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].voting_power.sole.unit`# required	string	Unit
`ownership_rows[].voting_power.shared`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].voting_power.shared.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].voting_power.shared.unit`# required	string	Unit
`ownership_rows[].dispositive_power`# required	object	Row-level sole/shared power over the shares. Never inferred by subtraction.
`ownership_rows[].dispositive_power.sole`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].dispositive_power.sole.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].dispositive_power.sole.unit`# required	string	Unit
`ownership_rows[].dispositive_power.shared`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].dispositive_power.shared.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].dispositive_power.shared.unit`# required	string	Unit
`ownership_rows[].footnotes`# required	array\| null items: object	Footnotes
`ownership_rows[].footnotes[].marker`# required	string\| null	Printed marker linking the note to its row (e.g. "(3)"). null when unmarked.
`ownership_rows[].footnotes[].text`# required	string\| null	Footnote prose, verbatim.
`ownership_rows[].evidence`# required	object	Evidence object. Never null.
`ownership_rows[].evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`ownership_rows[].evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).

Example dataset#

An illustrative example for beneficial_ownership. Use it to see the shape of the data before running a live request.

Top-level fields in the example dataset
Field	Summary
reference_date	2025-04-01
five_percent_holder_count	2
ownership_rows	1 item

Playground#

Response schema#

Fields 56

Field path	Type	Description
`reference_date`# required	object	As-of date the ownership snapshot is measured on, with its evidence.
`reference_date.value`# required	string\| null	ISO 8601 date; partial forms allowed. Never infer components absent from the source; null when not disclosed.
`reference_date.evidence`# required	object	Evidence object. Never null.
`reference_date.evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`reference_date.evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`five_percent_holder_count`# required	object	How many holders the source designates as 5%-or-greater beneficial owners.
`five_percent_holder_count.value`# required	integer\| null	Count of source-designated 5% holder rows. null when no such row family exists.
`five_percent_holder_count.evidence`# required	object	Evidence object. Never null.
`five_percent_holder_count.evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`five_percent_holder_count.evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`ownership_rows`# required	array\| null items: object	Ownership Rows
`ownership_rows[].name`# required	string\| null	Name
`ownership_rows[].investor_type`# required	string\| null	Investor Type
`ownership_rows[].company_role`# required	string\| null	Company role or source ownership label, as printed (director, NEO, 5% stockholder, management group).
`ownership_rows[].shareholdings`# required	array\| null items: object	null for a printed row whose current-ownership cells are all dashes.
`ownership_rows[].shareholdings[].share_class`# required	string\| null	Broad canonical class (`Common Stock`, `Preferred Stock`).
`ownership_rows[].shareholdings[].security_label`# required	string\| null	Source-derived qualifier for the class (`Class B`, `STRC Stock`). null when none.
`ownership_rows[].shareholdings[].shares_owned`# required	object	Printed beneficial ownership total for this class in the holder's row.
`ownership_rows[].shareholdings[].shares_owned.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].shareholdings[].shares_owned.unit`# required	string	Unit
`ownership_rows[].shareholdings[].percent_of_class`# required	object	A percentage. `unit` is always `"percent"`.
`ownership_rows[].shareholdings[].percent_of_class.value`# required	number\| null	Value
`ownership_rows[].shareholdings[].percent_of_class.unit`# required	string	Unit
`ownership_rows[].shareholdings[].components`# required	array\| null items: object	Components
`ownership_rows[].shareholdings[].components[].component_label`# required	string\| null	Source table column or footnote label, verbatim. Two components of one holder must not read alike while the source separates those lots — carry the separating words (named trustee, holder of record, series, beneficiary) into each label.
`ownership_rows[].shareholdings[].components[].holding_form`# required	string\| null	Normalized instrument/source or ownership form. null when unclear.
`ownership_rows[].shareholdings[].components[].is_beneficial_ownership`# required	boolean\| null	Whether this piece counts toward beneficial ownership. null when uncertain.
`ownership_rows[].shareholdings[].components[].shares_owned`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].shareholdings[].components[].shares_owned.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].shareholdings[].components[].shares_owned.unit`# required	string	Unit
`ownership_rows[].shareholdings[].components[].evidence`# required	object	Evidence object. Never null.
`ownership_rows[].shareholdings[].components[].evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`ownership_rows[].shareholdings[].components[].evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).
`ownership_rows[].total_voting_power_percent`# required	object	A percentage. `unit` is always `"percent"`.
`ownership_rows[].total_voting_power_percent.value`# required	number\| null	Value
`ownership_rows[].total_voting_power_percent.unit`# required	string	Unit
`ownership_rows[].voting_power`# required	object	Row-level sole/shared power over the shares. Never inferred by subtraction.
`ownership_rows[].voting_power.sole`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].voting_power.sole.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].voting_power.sole.unit`# required	string	Unit
`ownership_rows[].voting_power.shared`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].voting_power.shared.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].voting_power.shared.unit`# required	string	Unit
`ownership_rows[].dispositive_power`# required	object	Row-level sole/shared power over the shares. Never inferred by subtraction.
`ownership_rows[].dispositive_power.sole`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].dispositive_power.sole.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].dispositive_power.sole.unit`# required	string	Unit
`ownership_rows[].dispositive_power.shared`# required	object	A share count. `unit` is always `"shares"`.
`ownership_rows[].dispositive_power.shared.value`# required	unioninteger \| number \| null	Value
`ownership_rows[].dispositive_power.shared.unit`# required	string	Unit
`ownership_rows[].footnotes`# required	array\| null items: object	Footnotes
`ownership_rows[].footnotes[].marker`# required	string\| null	Printed marker linking the note to its row (e.g. "(3)"). null when unmarked.
`ownership_rows[].footnotes[].text`# required	string\| null	Footnote prose, verbatim.
`ownership_rows[].evidence`# required	object	Evidence object. Never null.
`ownership_rows[].evidence.quote`# required	string\| null	Verbatim excerpt from the filing proving this entry. Shortest contiguous source span; no ellipsis, no translation. null when there is no textual basis.
`ownership_rows[].evidence.reasoning`# required	string	How the source maps to this value. For null decisions, state the basis (not disclosed / not applicable / indeterminable / scope limitation).

Field

Summary

reference_date

2025-04-01

five_percent_holder_count

ownership_rows

1 item