All APIsexpand_more
Directors and corporate auditors
/stable/directors1 tokens per callNewFrom the annual securities report, returns the board members and auditors (or executive officers) with title, name, date of birth, term of office, shares held and career summary. When disclosed, the number of male and female officers and the female ratio (0–1 decimal) are included.
What you can do with this API
- check_circleCheck who is on the management team and their backgrounds
- check_circleGauge management's stake in the company from officers' shareholdings
- check_circleCompare the share of women on boards across companies
Example URL
https://api.zenithcode.net/stable/directors?symbol=7203&fiscalPeriod=2026-03Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
symbolstring | Required | Securities code (4 characters, e.g. 7203 = Toyota Motor; alphanumeric codes such as 130A also work) | 7203 |
fiscalPeriodstring | Optional | Fiscal period (YYYY-MM, e.g. 2026-03 = fiscal year ending March 2026). Defaults to the latest | 2026-03 |
Try it
Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 1 tokens.
travel_exploreTry in the API ViewerResponse example (real data)
Response fields
symbol | string | |
fiscalPeriod | string | |
period | string | |
docId | string | |
docTypeCode | string | |
submittedAt | string | |
sourceUrlEDINET原本へのリンク | string | EDINET原本へのリンク |
sourcefacts=XBRL ファクト / html=役員の状況 TextBlock の表を解析(ファクトが無い有報) | string | facts=XBRL ファクト / html=役員の状況 TextBlock の表を解析(ファクトが無い有報) |
counts男女別の役員数(開示があれば) | object | 男女別の役員数(開示があれば) |
officers | array |
Related APIs
FAQ
What does the source field mean?expand_more
It shows where the officer data came from: structured XBRL facts when the filing has them, otherwise the officers table parsed from the report.
How many tokens does one call use?expand_more
1 tokens per call, regardless of how many rows come back. Your monthly allowance depends on your plan.
Do I need an account to try it?expand_more
Use the API Viewer to run it with your own parameters. Sign up for free and sign in (no credit card). Each run uses this API's tokens.
Can I get CSV instead of JSON?expand_more
Add format=csv to the URL to get CSV, ready for spreadsheets or pandas.
Can I get labels in English?expand_more
With neither lang nor Accept-Language, labels such as sector names are returned in English; add lang=ja or send Accept-Language: ja for Japanese. Company and sector names are always returned in both languages as nameJa / nameEn and sectorJa / sectorEn. Field names are the same in both languages.

