Dividend history

GET/api/earnings/dividend-history

Returns dividend history for the given company symbol. Includes dividend per share (total dividends / shares outstanding), payout ratio (dividends / net income), dividend coverage (operating cash flow / dividends), and year-over-year growth. Non-dividend-paying companies return null values. Data is sourced from SEC XBRL filings (10-K and 10-Q).

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

currency string optional default "USD"

Currency to return all monetary values in (default USD).

Pass any ISO 4217 code from the table below, or original to disable conversion and receive every figure in its own as-reported currency. With a target currency, any line item not already in it is converted on the fly at the period-appropriate rate (spot for balance-sheet instants, period-average for income/cash-flow flows); values already in the target pass through untouched (no round-trip), and the per-period fx block records the rate(s) applied. A currency that cannot be priced for a given period leaves those facts native and flags them under fx.unconverted.

Accepted values

Code	Currency
`original`	Return every value in its original as-reported currency (no conversion)
`USD`	US Dollar — default
`AED`	United Arab Emirates Dirham
`AFN`	Afghan Afghani
`ALL`	Albanian Lek
`AMD`	Armenian Dram
`ANG`	Netherlands Antillean Guilder
`AOA`	Angolan Kwanza
`ARS`	Argentine Peso
`AUD`	Australian Dollar
`AWG`	Aruban Florin
`AZN`	Azerbaijani Manat
`BAM`	Bosnia-Herzegovina Convertible Mark
`BBD`	Barbadian Dollar
`BDT`	Bangladeshi Taka
`BGN`	Bulgarian Lev
`BHD`	Bahraini Dinar
`BIF`	Burundian Franc
`BMD`	Bermudan Dollar
`BND`	Brunei Dollar
`BOB`	Bolivian Boliviano
`BRL`	Brazilian Real
`BSD`	Bahamian Dollar
`BTN`	Bhutanese Ngultrum
`BWP`	Botswanan Pula
`BYN`	Belarusian Ruble
`BZD`	Belize Dollar
`CAD`	Canadian Dollar
`CDF`	Congolese Franc
`CHF`	Swiss Franc
`CLP`	Chilean Peso
`CNY`	Chinese Yuan
`COP`	Colombian Peso
`CRC`	Costa Rican Colón
`CUP`	Cuban Peso
`CVE`	Cape Verdean Escudo
`CZK`	Czech Koruna
`DJF`	Djiboutian Franc
`DKK`	Danish Krone
`DOP`	Dominican Peso
`DZD`	Algerian Dinar
`EGP`	Egyptian Pound
`ERN`	Eritrean Nakfa
`ETB`	Ethiopian Birr
`EUR`	Euro
`FJD`	Fijian Dollar
`FKP`	Falkland Islands Pound
`GBP`	British Pound
`GEL`	Georgian Lari
`GHS`	Ghanaian Cedi
`GIP`	Gibraltar Pound
`GMD`	Gambian Dalasi
`GNF`	Guinean Franc
`GTQ`	Guatemalan Quetzal
`GYD`	Guyanaese Dollar
`HKD`	Hong Kong Dollar
`HNL`	Honduran Lempira
`HTG`	Haitian Gourde
`HUF`	Hungarian Forint
`IDR`	Indonesian Rupiah
`ILS`	Israeli New Shekel
`INR`	Indian Rupee
`IQD`	Iraqi Dinar
`IRR`	Iranian Rial
`ISK`	Icelandic Króna
`JMD`	Jamaican Dollar
`JOD`	Jordanian Dinar
`JPY`	Japanese Yen
`KES`	Kenyan Shilling
`KGS`	Kyrgyz Som
`KHR`	Cambodian Riel
`KMF`	Comorian Franc
`KPW`	North Korean Won
`KRW`	South Korean Won
`KWD`	Kuwaiti Dinar
`KYD`	Cayman Islands Dollar
`KZT`	Kazakhstani Tenge
`LAK`	Laotian Kip
`LBP`	Lebanese Pound
`LKR`	Sri Lankan Rupee
`LRD`	Liberian Dollar
`LSL`	Lesotho Loti
`LYD`	Libyan Dinar
`MAD`	Moroccan Dirham
`MDL`	Moldovan Leu
`MGA`	Malagasy Ariary
`MKD`	Macedonian Denar
`MMK`	Myanmar Kyat
`MNT`	Mongolian Tugrik
`MOP`	Macanese Pataca
`MRU`	Mauritanian Ouguiya
`MUR`	Mauritian Rupee
`MVR`	Maldivian Rufiyaa
`MWK`	Malawian Kwacha
`MXN`	Mexican Peso
`MYR`	Malaysian Ringgit
`MZN`	Mozambican Metical
`NAD`	Namibian Dollar
`NGN`	Nigerian Naira
`NIO`	Nicaraguan Córdoba
`NOK`	Norwegian Krone
`NPR`	Nepalese Rupee
`NZD`	New Zealand Dollar
`OMR`	Omani Rial
`PAB`	Panamanian Balboa
`PEN`	Peruvian Sol
`PGK`	Papua New Guinean Kina
`PHP`	Philippine Peso
`PKR`	Pakistani Rupee
`PLN`	Polish Zloty
`PYG`	Paraguayan Guarani
`QAR`	Qatari Riyal
`RON`	Romanian Leu
`RSD`	Serbian Dinar
`RUB`	Russian Ruble
`RWF`	Rwandan Franc
`SAR`	Saudi Riyal
`SBD`	Solomon Islands Dollar
`SCR`	Seychellois Rupee
`SDG`	Sudanese Pound
`SEK`	Swedish Krona
`SGD`	Singapore Dollar
`SHP`	St. Helena Pound
`SLE`	Sierra Leonean Leone
`SOS`	Somali Shilling
`SRD`	Surinamese Dollar
`SSP`	South Sudanese Pound
`STN`	São Tomé & Príncipe Dobra
`SVC`	Salvadoran Colón
`SYP`	Syrian Pound
`SZL`	Swazi Lilangeni
`THB`	Thai Baht
`TJS`	Tajikistani Somoni
`TMT`	Turkmenistani Manat
`TND`	Tunisian Dinar
`TOP`	Tongan Paʻanga
`TRY`	Turkish Lira
`TTD`	Trinidad & Tobago Dollar
`TWD`	New Taiwan Dollar
`TZS`	Tanzanian Shilling
`UAH`	Ukrainian Hryvnia
`UGX`	Ugandan Shilling
`UYU`	Uruguayan Peso
`UZS`	Uzbekistani Som
`VES`	Venezuelan Bolívar
`VND`	Vietnamese Dong
`VUV`	Vanuatu Vatu
`WST`	Samoan Tala
`XAF`	Central African CFA Franc
`XCD`	East Caribbean Dollar
`XDR`	Special Drawing Rights
`XOF`	West African CFA Franc
`XPF`	CFP Franc
`YER`	Yemeni Rial
`ZAR`	South African Rand
`ZMW`	Zambian Kwacha
`ZWG`	Zimbabwean Gold

Example: USD

period string (enum) optional

Reporting period. ttm returns trailing twelve months (single entry).
limit integer optional min 1 · max 40 · default 10

Maximum number of periods to return (may be clamped by subscription tier)
splitAdjust boolean optional default true

On by default: dividendPerShare and dividendGrowth are normalized onto the current split-adjusted basis (the share count in the per-share denominator is split-adjusted) so the series is continuous across stock splits. totalDividendsPaid, payoutRatio, and dividendCoverage are unaffected. Pass false to get the raw values exactly as originally filed.

Example request

curl 'https://api.stockfit.io/v1/api/earnings/dividend-history?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8&currency=USD' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Array of dividend history entries sorted most recent first

Response schema

array of:

period string
Fiscal period end date (YYYY-MM-DD)
fiscalYear integer
The company's fiscal year (handles non-December year-ends — AAPL FY ends Sep, COST FY ends Aug).
fiscalPeriod string (enum)
Fiscal period of a reported value: `FY` (annual), `Q1`-`Q4` (quarterly), or `TTM` (trailing twelve months).
Allowed values: FY, Q1, Q2, Q3, Q4, TTM
dividendPerShare number | null
Dividend per share (total dividends / weighted average shares outstanding)
totalDividendsPaid number | null
Total cash dividends paid in the requested currency (default USD)
payoutRatio number | null
Payout ratio as a decimal (dividends / net income). Above 1.0 means paying more than earned.
dividendCoverage number | null
Dividend coverage ratio (operating cash flow / dividends). Below 1.0 is unsustainable.
dividendGrowth number | null
Year-over-year dividend per share growth as a decimal (0.05 = 5%)

Example response

[
  {
    "period": "2024-09-28",
    "fiscalYear": 2025,
    "fiscalPeriod": {},
    "dividendPerShare": 0.99,
    "totalDividendsPaid": 15234000000,
    "payoutRatio": 0.1625,
    "dividendCoverage": 7.77,
    "dividendGrowth": 0.0408
  }
]

400 Bad Request

Invalid parameters or symbol not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}