%22%20d%3D%22M50.5%2036.41A25%2025%200%200%201%2036.41%2050.5L31.27%2037.48A11%2011%200%200%200%2037.48%2031.27Z%22%2F%3E%0A%3C%2Fsvg%3E){kind=small}
What each dividend includes
| Field | What it is | ASX:BHP, March 2026 |
|---|---|---|
exDate, recordDate, payDate | The ex, record and pay dates. from and to filter on the ex date | 2026-03-05, 2026-03-06, 2026-03-26 |
amount, adjustedAmount | Per share as declared, and adjusted for every split and consolidation since | 0.73, 0.73 |
currency | What the dividend is paid in. BHP declares in US dollars | USD |
status | announced, confirmed, paid or cancelled | paid |
type | regular, interim, final, special, return_of_capital or capital_gains | regular |
au.frankedPct | How much of the dividend is franked, from 0 to 100 | 100 |
au.taxRatePct | The company tax rate the dividend was franked at | 30 |
au.frankingCredit | The franking credit per share | 0.31285714 |
au.conduitForeignIncome | Conduit foreign income per share | 0 |
drp.price, drp.discountPct | The reinvestment plan price and its discount to market | 35.247509, 0 |
Changes and cancellations
Companies often announce a dividend more than once. The DRP price usually comes after the pricing period ends, and dividends get corrected or cancelled after they're announced. Each change updates the same dividend, so you get one record per dividend with the latest numbers, and its status only moves forward from announced to confirmed to paid.
We work out the franking credit from the franked amount and the company's tax rate, the way the ATO does: franked amount × rate ÷ (1 − rate). A fully franked 70 cent dividend at 30% carries a 30 cent credit.
Franked at 25% or 30%
Not every company franks at 30%. A base rate entity, which is a company with turnover under $50 million and no more than 80% passive income, franks at 25% from the 2021-22 income year, 26% in 2020-21 and 27.5% from 2017-18 to 2019-20. The rate depends on the company's previous year, so it can change from one year to the next.
A fully franked 70 cent dividend at 25% carries a credit of 23.33 cents, not 30. Tools that assume 30% overstate
it, so we use the rate the company declared. When a form gives no rate, frankingCredit is null. The
ATO explains the calculation in allocating franking credits.
Questions
Does it cover dividends outside Australia?
Yes. It returns dividends for listings on any exchange we cover, like NASDAQ:AAPL. The au object with the franking fields is only on ASX dividends.
How far back does the franking data go?
To dividends with an ex date from 1 September 2015, for ASX companies and funds. For some funds, like Vanguard's ETFs from 2017, the franking credit and DRP price are there but the franked percentage and tax rate are null.
Why is frankingCredit null on some dividends?
Either the company didn't state a tax rate, or it's an estimated dividend whose numbers don't add up yet. We'd rather leave it null than assume 30% and get it wrong.
When does the DRP price show up?
When the company announces it, which is usually after the DRP pricing period ends, often days after the ex date. Until then drp.price is null.
What happens when a company changes or cancels a dividend?
The update corrects the same dividend, so you never get two versions of it. A cancellation sets status to cancelled. Status only moves forward, so a notice that arrives late or out of order can't undo a newer one.
Can I use these numbers for a tax return?
They're the figures the company declared. The ATO pre-fills returns from the statements share registries send out, so if the two ever differ, go with your statement.
What does it cost?
1 credit per instrument. It's included in every plan, Free included, and in the trial. Anything that comes back as an error isn't billed.