All APIsexpand_more

Workforce (headcount, average age, tenure and salary)

GET/stable/workforce1 tokens per call

From the latest annual securities report, returns the parent-company employee count, average age, average years of service and average annual salary, plus consolidated employees by segment. Salary is in JPY.

What you can do with this API

check_circleCompare average salary and age with competitors
check_circleUse average tenure as a rough sign of employee retention
check_circleSee how headcount is spread across business segments

Example URL

https://api.zenithcode.net/stable/workforce?symbol=7203&fiscalPeriod=2026-03

Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.

Parameters

Parameter	Required	Description	Example
`symbol` string	Required	Securities code (4 characters, e.g. 7203 = Toyota Motor; alphanumeric codes such as 130A also work)	`7203`
`fiscalPeriod` string	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 Viewer

Response example (real data)

lock

Live response examples are shown to signed-in users only (they include exchange data such as stock prices). Sign in to view

Response fields

`symbol`	string
`fiscalPeriod`	string
`period`	string
`docId`	string
`docTypeCode`	string
`submittedAt`	string
`employees`提出会社の従業員数（人）	number	提出会社の従業員数（人）
`averageAge`平均年齢（歳）	number	平均年齢（歳）
`averageTenureYears`平均勤続年数（年）	number	平均勤続年数（年）
`averageAnnualSalary`提出会社の平均年間給与（円）。有報の XBRL の値。無い書類は表の値を円に換算し、100 万円〜1 億円の範囲外なら null	number	提出会社の平均年間給与（円）。有報の XBRL の値。無い書類は表の値を円に換算し、100 万円〜1 億円の範囲外なら null
`consolidatedEmployees`連結従業員数（人）。連結子会社が無い会社は null	number	連結従業員数（人）。連結子会社が無い会社は null
`segments`連結のセグメント別従業員数	array	連結のセグメント別従業員数
`parentSegments`提出会社（単体）のセグメント別従業員数。データ基盤が連結と分けた書類だけ（無ければ空）	array	提出会社（単体）のセグメント別従業員数。データ基盤が連結と分けた書類だけ（無ければ空）
`sourceUrl`EDINET原本へのリンク	string	EDINET原本へのリンク

Related APIs

Employee count

/stable/employee-count

Diversity metrics (women in management, paternity leave, gender pay gap)New

/stable/diversity

Director and officer compensationNew

/stable/director-compensation

FAQ

Is the average salary for the whole group?expand_more

No. It is the average for the reporting company itself (non-consolidated), so overseas subsidiaries are not included.

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.