Docs/Reference/Ownership/Get Board Composition
GET/v1/companies/{code}/boardTier · Developer

Get Board Composition

Get board composition and officer list for a company.

Returns directors, auditors, and executive officers with outside/independent status, gender breakdown, and shares held.

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

Query parameters · 1

Optional filters and modifiers. Pass as URL-encoded ?key=value.

fiscal_yearinteger | nulloptional

Fiscal year. Defaults to latest.

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains BoardCompositionOut.

Envelope

dataBoardCompositionOut

A single result object.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

BoardCompositionOut

edinet_codestring

EDINET code

securities_codestring | null

Securities code

fiscal_yearinteger

Fiscal year

total_directorsinteger

Number of directors

total_auditorsinteger

Number of auditors

total_executive_officersinteger

Number of executive officers

male_countinteger | null

Male count

female_countinteger | null

Female count

female_ratio_pctnumber | null

Female ratio (%)

outside_director_countinteger

Outside directors + auditors

independent_director_ratio_pctnumber | null

Independent director ratio (%)

officersBoardMemberOut[]

Individual officers

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.