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

Main customers (10%+ of revenue)

GET/stable/main-customers1 tokens per call

From the notes of the annual securities report, returns customers that account for 10% or more of revenue: customer name, revenue from that customer (JPY) and the related segment, for the current and prior year. Companies with no such customer respond with HTTP 404.

What you can do with this API

  • check_circleCheck whether revenue depends heavily on a few customers
  • check_circleFind the main buyers of a supplier company
  • check_circleCompare revenue from each customer with the prior year

Example URL

https://api.zenithcode.net/stable/main-customers?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原本へのリンク
sourceTag表を取った TextBlock のタグstring表を取った TextBlock のタグ
customersarray

Related APIs

FAQ

Why do I get a 404?expand_more

The company's report lists no customer above 10% of revenue. It means "nothing to show", not a failure.

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.