All APIsexpand_more
Dividend policies list and screen
/stable/dividend-policies10 tokens per callNewReturns verified dividend policies of currently listed companies, one row per policy. Filter by type (DOE, payout ratio, total return ratio, progressive dividend, minimum dividend or qualitative only) and by DOE or payout-ratio thresholds. Thresholds are 0-1 decimals compared with the target value, or the lower end of the range when there is no single value. Page through the list in code order with limit and offset.
What you can do with this API
- check_circleList companies that use a DOE target
- check_circleFind companies that explicitly commit to progressive dividends
- check_circleScreen for companies targeting a payout ratio of 40% or more
Example URL
https://api.zenithcode.net/stable/dividend-policies?metric=doe&status=current§or=3700&minPayoutRatio=0.3&minDoe=0.03&limit=100&offset=0Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
metricselect | Optional | Policy type: all (default), doe, payout_ratio, total_return_ratio, progressive (explicitly stated), dividend_floor or qualitative_only Allowed values: all, doe, payout_ratio, total_return_ratio, progressive, dividend_floor, qualitative_only | doe |
statusselect | Optional | current = policies in effect (default), scheduled = announced policies Allowed values: current, scheduled | current |
sectorstring | Optional | TSE 33-sector code (e.g. 3700 = Transportation Equipment). See /stable/available-sectors | 3700 |
minPayoutRatiostring | Optional | Minimum payout ratio (0-1 decimal; 0.4 = 40%) | 0.3 |
maxPayoutRatiostring | Optional | Maximum payout ratio (0-1 decimal) | |
minDoestring | Optional | Minimum DOE (0-1 decimal; 0.03 = 3%) | 0.03 |
maxDoestring | Optional | Maximum DOE (0-1 decimal) | |
limitnumber | Optional | Maximum number of rows to return (default 100, max 1,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
policyIdPolicy identifier | string | Policy identifier |
versionVersion number | integer | Version number |
symbol | string | |
sectorCodeTSE 33-sector code (active listing) | string | TSE 33-sector code (active listing) |
policyStatuscurrent / scheduled / superseded / withdrawn | string | current / scheduled / superseded / withdrawn |
doeDividend on equity (DOE) target. null when the policy has none | object | Dividend on equity (DOE) target. null when the policy has none |
payoutRatioPayout ratio target. null when the policy has none | object | Payout ratio target. null when the policy has none |
totalReturnRatioTotal shareholder return ratio target (dividends + buybacks). Separate from the payout ratio | object | Total shareholder return ratio target (dividends + buybacks). Separate from the payout ratio |
progressivePolicyexplicit = progressive dividend (no cuts) stated, not_stated = not stated, withdrawn = abandoned | string | explicit = progressive dividend (no cuts) stated, not_stated = not stated, withdrawn = abandoned |
dividendFloorMinimum dividend per share. null when the policy has none | object | Minimum dividend per share. null when the policy has none |
conditionsCompound condition (e.g. "the higher of DOE 3% or payout 40%"). Not reduced to one number | object | Compound condition (e.g. "the higher of DOE 3% or payout 40%"). Not reduced to one number |
effectiveFrom | object | |
effectiveTo | object | |
source | object | |
verifiedAtWhen the policy was verified against the source (UTC) | string | When the policy was verified against the source (UTC) |
evidenceSource quotes supporting the numeric fields | array | Source quotes supporting the numeric fields |
qualitativePoliciesQualitative policy statements. Empty means not yet confirmed, not "no policy" | array | Qualitative policy statements. Empty means not yet confirmed, not "no policy" |
summaryJaThe confirmed qualitative statements joined (Japanese, no numbers) | string | The confirmed qualitative statements joined (Japanese, no numbers) |
Related APIs
FAQ
Does a company missing from the list have no dividend policy?expand_more
Not necessarily. Companies that have not been collected and verified yet are not listed. Check the status field of the single-company dividend policy endpoint.
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.