Historical Dividends API – Finnworlds

The Historical Dividends API by Finnworlds provides structured historical dividend data issued by public companies. This RESTful API returns dividend payment amounts along with dates in a clean JSON format — ideal for developers, analysts, and platforms that track dividend-paying stocks.

Dividends reflect how consistently a company distributes its profits to shareholders. With Finnworlds, you can instantly retrieve quarterly, semi-annual, or annual dividend data, updated continuously to reflect the latest declarations. The historical database ensures financial continuity and is optimized for valuation models, dashboards, or research tools.

Used by investors, fintech platforms, economists, and academic researchers alike, the API provides dividend payment histories that support performance analysis, portfolio reporting, and dividend yield calculations. JSON output is the default, but users can also opt for CSV downloads, PDF exports, or scheduled email delivery.

Common Use Cases

– Financial statement analysis and company valuation models
– Integrating dividend history into stock screeners and investment dashboards
– Portfolio performance and income forecasting
– Academic or institutional research on dividend-paying firms

API Features

• Dividend Amount – Historical payout rate per share
• Dividend Date – Official record date of payment
• Ticker Support – Lookup by symbol
• Date Range Queries – Filter data by specific date intervals

Get started by getting your API key on the Finnworlds website. Looking for academic or non-profit use? Reach out by email to discuss discounted access or custom options.

How to Access the Historical Dividends Data

• JSON REST API
• Excel CSV download
• PDF reports
• Email link

Documentation

Our documentation includes input parameters, output object definitions, usage examples, and detailed endpoint specs. SDKs are available for major languages and frameworks including Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Strest, Rust, Swift, and Scala.

Examples

https://api.finnworlds.com/api/v1/dividends?key=APIKEY&ticker=AAPL

https://api.finnworlds.com/api/v1/dividends?key=APIKEY&ticker=AAPL&date_from=2024-01-01&date_to=2025-03-20

{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "ticker": "AAPL"
        },
        "output": {
            "dividends": [
                {
                    "dividend_rate": "0.25",
                    "date": "2025-02-10"
                },
                {
                    "dividend_rate": "0.25",
                    "date": "2024-11-08"
                },
                {
                    "dividend_rate": "0.25",
                    "date": "2024-08-12"
                },
                {
                    "dividend_rate": "0.25",
                    "date": "2024-05-10"
                },
                {
                    "dividend_rate": "0.24",
                    "date": "2024-02-09"
                }
            ]
        }
    }
}

Customer Support

Need help, have questions? Get in touch with Support.

Legal

Use of the Finnworlds website, services like API and database are subject to the Finnworlds Terms & Conditions.