Get free API key
All APIsexpand_more
search
appsAll APIs
functionHow metrics are calculated

Treasury shares (voting-rights disclosure)

GET/stable/treasury-shares1 tokens per call

From the "voting rights" section of the annual securities report, returns treasury shares (held in the company's own name, in others' names and in total), holder rows, the ratio to issued shares (0.05 = 5%) and issued shares per share class. This table is a voting-rights disclosure under the Companies Act, not the consolidated accounting count, so shares outstanding cannot be derived from it. Consolidated period-end share counts from the earnings release are returned separately in consolidated.

What you can do with this API

  • check_circleGauge the scale of share buybacks from the treasury-share ratio
  • check_circleCheck issued shares including each share class
  • check_circleCompare with the consolidated share counts from the earnings release

Example URL

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

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

Parameters

ParameterRequiredDescriptionExample
symbol
string
RequiredSecurities code (4 characters, e.g. 7203 = Toyota Motor; alphanumeric codes such as 130A also work)7203
fiscalPeriod
string
OptionalFiscal period (YYYY-MM, e.g. 2026-03 = fiscal year ending March 2026). Defaults to the latest2026-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

symbolstring
fiscalPeriodstring
periodstring
docIdstring
docTypeCodestring
submittedAtstring
sourceUrlEDINET原本へのリンクstringEDINET原本へのリンク
votingRightsTable有報「議決権の状況」の自己株式等(会社法 308 条ベースの開示)。連結の自己株式数ではないobject有報「議決権の状況」の自己株式等(会社法 308 条ベースの開示)。連結の自己株式数ではない
issuedSharesarray
consolidated連結ベースの期末株数(短信サマリー)。同じ決算期の FY 行が無ければ nullobject連結ベースの期末株数(短信サマリー)。同じ決算期の FY 行が無ければ null

Related APIs

FAQ

Can I compute shares outstanding from this?expand_more

No. This table is a voting-rights disclosure with a different scope than consolidated treasury shares. Use the consolidated field for consolidated share counts.

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.