Officers and pay

Officers are disclosed once a year, in the annual report. These methods therefore give a yearly snapshot, not a record of appointments and resignations. All of them have amendment filings applied.

Officers

get_officers

Ticker.officers -> pandas.DataFrame
Ticker.get_officers(year=None) -> pandas.DataFrame

The officers named in the annual report.

Parameters

Name	Type	Default	Description
`year`	`int`	`None`	Fiscal year. Latest annual report when omitted. Available years are in `.attrs["years"]`

Returns — pandas.DataFrame, one row per officer.

Column	Type	Description
`Name`	`str`	Name as filed
`Title`	`str`	Title
`Birth Date`	`datetime64`	Date of birth
`Term Of Office`	`str`	Term as filed
`Shares Held`	`float`	Shares held, converted to a share count. `NaN` where the unit cannot be read
`Shares Held Raw`, `Shares Unit`	`float`, `str`	The figure and unit as filed
`Is Proposal`	`bool`	`True` for candidates put to a general meeting, not yet appointed
`Source`	`str`	`xbrl` where the value came from tagged data, `textblock_html` where it was read from the filing’s HTML
`Document ID`	`str`	EDINET document ID

Remuneration

get_officer_compensation

Ticker.officer_compensation -> pandas.DataFrame
Ticker.get_officer_compensation(as_dict=False) -> pandas.DataFrame | dict

Individual officer remuneration, for every fiscal year. Japanese law requires individual disclosure only where consolidated remuneration reaches 100 million yen, so most officers never appear.

Parameters

Name	Type	Default	Description
`as_dict`	`bool`	`False`	Return a `dict` instead of a `DataFrame`

Returns — pandas.DataFrame

Column	Type	Description
`fiscalYear`	`int`	Fiscal year
`name`	`str`	Name as filed
`totalPay`	`float`	Total remuneration, in yen
`documentId`	`str`	The annual report the row belongs to
`sourceDocumentId`	`str`	The filing the value was taken from, which is the amendment where one exists
`isCorrected`	`bool`	Whether an amendment changed the value
`correctionSource`	`str`	The amendment that changed it

get_officer_remuneration

Ticker.officer_remuneration -> pandas.DataFrame
Ticker.get_officer_remuneration(breakdown="standard") -> pandas.DataFrame

Remuneration by officer category — directors, corporate auditors, outside officers and so on — for every fiscal year, newest first.

Parameters

Name	Type	Default	Description
`breakdown`	`str`	`"standard"`	`"standard"` gives one row per fiscal year × category. `"all"` gives one row per fiscal year × category × item

Returns — pandas.DataFrame

With breakdown="standard":

Column	Type	Description
`Fiscal Year`	`int`	Fiscal year
`Category`, `Category Label`	`str`	Officer category and its label
`Total Amount`	`float`	Total remuneration, in yen
`Officer Count`	`float`	Number of officers
`Fixed`, `Base`, `Performance Based`, `Bonus`, `Non Monetary`, `Share Awards`, `Restricted Share Awards`, `Performance Linked Share Awards`, `Share Option`, `Retirement`	`float`	Breakdown, one column per standard EDINET element the company uses
`Document ID`	`str`	EDINET document ID

Items a company has defined for itself are not folded into the standard columns, because their meaning differs between companies. The breakdown columns therefore need not add up to Total Amount.

With breakdown="all", every item in the filing is returned, company-defined items included:

Column	Type	Description
`Fiscal Year`	`int`	Fiscal year
`Category`, `Category Label`	`str`	Officer category and its label
`Local Name`	`str`	XBRL element name
`Standard`	`str`	Matching standard column name, or `None` for a company-defined item
`Value`	`float`	Value as filed. Some company-defined items are headcounts rather than amounts
`Document ID`	`str`	EDINET document ID

get_audit_fees

Ticker.audit_fees -> pandas.DataFrame
Ticker.get_audit_fees() -> pandas.DataFrame

Fees paid for audit and non-audit services, for every fiscal year, newest first. Rows where Network Firms is True are fees paid to firms in the same network as the auditor.

Returns — pandas.DataFrame

Column	Type	Description
`Fiscal Year`	`int`	Fiscal year
`Network Firms`	`bool`	Whether the row covers network firms rather than the auditor
`Audit Reporting Company`, `Audit Consolidated Subsidiaries`, `Audit Total`	`float`	Audit fees, in yen
`Non Audit Reporting Company`, `Non Audit Consolidated Subsidiaries`, `Non Audit Total`	`float`	Non-audit fees, in yen
`Document ID`	`str`	EDINET document ID