All APIsexpand_more
Dividend policy of one company
/stable/dividend-policy1 tokens per callNewReturns the dividend policy of one company as verified against the source. For the policy in effect, scheduled policies and past policies it gives DOE, payout ratio and total return ratio targets (0-1 decimals, as a value or range, marked as floor, ceiling, guideline or target), the progressive-dividend stance, the minimum dividend, compound conditions such as "whichever is higher", the effective period, source quotes and qualitative statements. status tells apart a verified policy, a verified absence of any stated policy, policies under review and companies not yet covered.
What you can do with this API
- check_circleCheck DOE and payout targets to estimate future dividends
- check_circleSee whether a company commits to progressive or minimum dividends
- check_circleLearn about announced changes to the dividend policy
Example URL
https://api.zenithcode.net/stable/dividend-policy?symbol=7203Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
symbolstring | Required | Securities code (4 characters, e.g. 7203 = Toyota Motor; alphanumeric codes such as 130A also work) | 7203 |
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 ViewerResponse example (real data)
Response fields
symbol | string | |
statuspublished = a verified policy exists, not_stated = verified that the company states no policy, pending_review = under review, not_collected = not yet structured (NOT "no policy") | string | published = a verified policy exists, not_stated = verified that the company states no policy, pending_review = under review, not_collected = not yet structured (NOT "no policy") |
currentPolicy in effect | object | Policy in effect |
scheduledAnnounced policies not yet in effect | array | Announced policies not yet in effect |
supersededPast policies | array | Past policies |
lastVerifiedAtLatest verification time among the returned policies | string | Latest verification time among the returned policies |
Related APIs
FAQ
Does status = not_collected mean there is no dividend policy?expand_more
No. It means the policy has not been collected and verified yet. Companies verified to state no policy return not_stated.
How is "the higher of DOE 3% or a 40% payout ratio" represented?expand_more
Each metric carries its value as a floor, and conditions holds relation=higher_of. The two are not merged into one number.
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.