All APIsexpand_more
Shareholder benefits list
/stable/shareholder-benefits-list10 tokens per callNewReturns one row per company that has shareholder benefits: record months, the smallest required shares and minimum investment, benefit types, the items of the smallest tier with their stated and annual values, and whether there is a long-term bonus or a choice. Filter by record month, benefit type, required shares or investment, and page through the list in code order with limit and offset. With scope=all, companies confirmed to have no benefits and companies not yet confirmed are included as well.
What you can do with this API
- check_circleList benefits with a March record date
- check_circleFind stocks whose benefits need an investment of 100,000 yen or less
- check_circleCompare benefits by type, such as QUO cards or catalog gifts
Example URL
https://api.zenithcode.net/stable/shareholder-benefits-list?asOf=2026-10-19&scope=published&month=3&type=quo_card&minSharesLowerThan=100&minInvestmentLowerThan=300000&limit=100&offset=0Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
asOfstring | Optional | Publication date (YYYY-MM-DD, Japan time). Defaults to today | 2026-10-19 |
scopeselect | Optional | published = companies with a program in effect or scheduled (default); all = also companies confirmed to have none and companies not yet confirmed Allowed values: published, all | published |
monthnumber | Optional | Record month (1-12) (max 12) | 3 |
typeselect | Optional | Benefit type: quo_card, gift_card, own_product, discount, catalog, points, donation or other Allowed values: quo_card, gift_card, own_product, discount, catalog, points, donation, other | quo_card |
minSharesLowerThannumber | Optional | Only companies whose smallest required shares is at most this number | 100 |
minInvestmentLowerThanstring | Optional | Only companies whose minimum investment (yen) is at most this amount | 300000 |
limitnumber | Optional | Maximum number of rows to return (default 100, max 2,000) | 100 |
offsetstring | Optional | Number of rows to skip from the start (default 0) | 0 |
Try it
Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 10 tokens.
travel_exploreTry in the API ViewerResponse example (real data)
Response fields
symbol | string | |
companyNameCompany name | string | Company name |
sectorCodeTSE 33-sector code | string | TSE 33-sector code |
hasBenefitstrue / false / null (see /stable/shareholder-benefits). null is not "no benefits" | boolean | true / false / null (see /stable/shareholder-benefits). null is not "no benefits" |
coverageStatusReview coverage | string | Review coverage |
hasCurrentA program is in effect | boolean | A program is in effect |
hasScheduledA scheduled program exists | boolean | A scheduled program exists |
recordMonthsRecord months (1-12) | array | Record months (1-12) |
minSharesSmallest number of shares that qualifies | number | Smallest number of shares that qualifies |
minInvestmentJpyminShares × latest close (JPY) | number | minShares × latest close (JPY) |
priceDateDate of the close used for minInvestmentJpy | string | Date of the close used for minInvestmentJpy |
benefitTypesBenefit types offered | array | Benefit types offered |
headlineUp to 2 items of the smallest tier | array | Up to 2 items of the smallest tier |
statedValueJpyMinSmallest company-stated amount in the smallest tier (JPY) | number | Smallest company-stated amount in the smallest tier (JPY) |
annualValueJpyMinSmallest annual value in the smallest tier (JPY) | number | Smallest annual value in the smallest tier (JPY) |
annualValueBasisHow the annual value was obtained | string | How the annual value was obtained |
annualValueTimesSourceBasis of the times per year used | string | Basis of the times per year used |
hasLongTermBonusHas a long-term holding bonus | boolean | Has a long-term holding bonus |
hasChoiceHas choice rules | boolean | Has choice rules |
programCountNumber of programs | integer | Number of programs |
hasAlternativeProgramsPrograms are alternatives to each other | boolean | Programs are alternatives to each other |
hasAudienceProgramsPrograms target different shareholders | boolean | Programs target different shareholders |
nextRecordDateFirst record date of the earliest scheduled program | string | First record date of the earliest scheduled program |
lastReviewedAtLatest review date | string | Latest review date |
Related APIs
FAQ
Does a company missing from the list have no benefits?expand_more
Not necessarily. Companies that have not been confirmed yet are not listed. Use scope=all to see each company's status in hasBenefits.
How many tokens does one call use?expand_more
10 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.