Dividends

Get the dividends for a company

Changed on Oct 28, 2026

Returns a company's dividends, with amounts, dates and a link to each one's source filing where one is available. Also returns non-cash distributions, upcoming and preferred dividends, cancellations, dividends on other listings, dividends per share by fiscal period, and a summary of the trailing and forward dividend per share. A company with several share classes returns its primary class, or the class of the listing requested where that class has its own dividends, unless shareClass=all. The DPS figures describe that class, per share of the listing requested: per ADS for a depositary receipt, otherwise per share.

get/v1/company/dividends

Request

Base URL
https://api.fiscal.ai (the document declares no server; this is the origin it was published from)
URL
https://api.fiscal.ai/v1/company/dividends
Auth
API key in query parameter apiKey

Query parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

Example:MSFT

micCodestring

Company MIC, use with ticker

Example:XNAS

exchangestring

Company exchange code, use with ticker

Example:NASDAQ

companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

Example:594918104

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

Example:US5949181045

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

Example:BBG000BPH459

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Example:789019

fsclstring

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

Example:FSCLC6CGT4DXS597

shareClass'primary' | 'all'

primary (default) returns one share class: the class of the listing requested where it has its own dividends, otherwise the primary class. all returns every share class in dividends, nonCashDistributions and forwardDividends; the DPS figures, periodDps and annualizedDpsHistory stay on the default class, and the other arrays cover the whole company.

Example:primary

securityFiscalIdentifierstring

Return the dividends of one of the company's securities instead of the default share class; filters.securities lists them. Applies to dividends, nonCashDistributions, forwardDividends, the summary, periodDps and annualizedDpsHistory; preferredDividends, secondaryDividends and cancellations cover the whole company. An identifier that isn't one of the company's securities returns 404.

Example:FSCLS2URY4YPP321

Response

Dividends

Example response

{
  "summary": {
    "reportingCurrency": "USD",
    "annualizedDps": 1,
    "annualizedDpsSplitAdj": 1,
    "annualizedDpsCurrency": "USD",
    "annualizedDpsBasis": "sum",
    "annualizedDpsHeldSince": "2026-08-01",
    "annualizedTotalDps": 1.3,
    "annualizedTotalDpsSplitAdj": 1.3,
    "annualizedDpsSource": "precomputed",
    "annualizedDpsSecurityFiscalIdentifier": "FSCLS7AHC8GRU738",
    "forwardDps": 1.08,
    "forwardDpsSplitAdj": 1.08,
    "forwardDpsCurrency": "USD",
    "firstExDate": "2012-08-09",
    "latestExDate": "2024-08-12"
  },
  "filters": {
    "dividendTypes": [
      "Cash"
    ],
    "dividendSubtypes": [
      "Scrip"
    ],
    "frequencies": [
      "Quarterly"
    ],
    "statuses": [
      "declared"
    ],
    "currencies": [
      "USD"
    ],
    "shareClasses": [
      "Common Stock"
    ],
    "micCodes": [
      "XNAS"
    ],
    "securities": [
      {
        "securityFiscalIdentifier": "FSCLS7AHC8GRU738",
        "shareClassLabel": "Class A Common Stock",
        "isPrimary": true
      }
    ]
  },
  "dividends": [
    {
      "id": "a1b2c3d4e5f60718",
      "dividendType": "Cash",
      "dividendSubtype": [
        "Scrip"
      ],
      "frequency": "Quarterly",
      "status": "declared",
      "amount": 0.25,
      "distributionRatio": 0.1,
      "amountBasis": "as_declared",
      "currencyCode": "USD",
      "splitAdjFactor": 1,
      "splitAdjAmount": 0.25,
      "adsAdjFactor": 1,
      "adsAdjAmount": 0.25,
      "adsCurrentFactor": 1,
      "shareClassName": "Common Stock",
      "isPrimaryShareClass": true,
      "securityFiscalIdentifier": "FSCLS2URY4YPP321",
      "announceDate": "2024-08-01",
      "exDate": "2024-08-12",
      "recordDate": "2024-08-12",
      "payDate": "2024-08-15",
      "agmDate": "2024-04-25",
      "fiscalYear": 2024,
      "fiscalQuarter": 3,
      "exchangeName": "NASDAQ",
      "micCode": "XNAS",
      "reportDate": "2024-06-29",
      "sources": [
        {
          "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/pdf?companyKey=NASDAQ_AAPL",
          "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/page/3/image?companyKey=NASDAQ_AAPL",
          "pageNumber": 3
        }
      ]
    }
  ],
  "nonCashDistributions": [
    {
      "id": "a1b2c3d4e5f60718",
      "dividendType": "Cash",
      "dividendSubtype": [
        "Scrip"
      ],
      "frequency": "Quarterly",
      "status": "declared",
      "amount": 0.25,
      "distributionRatio": 0.1,
      "amountBasis": "as_declared",
      "currencyCode": "USD",
      "splitAdjFactor": 1,
      "splitAdjAmount": 0.25,
      "adsAdjFactor": 1,
      "adsAdjAmount": 0.25,
      "adsCurrentFactor": 1,
      "shareClassName": "Common Stock",
      "isPrimaryShareClass": true,
      "securityFiscalIdentifier": "FSCLS2URY4YPP321",
      "announceDate": "2024-08-01",
      "exDate": "2024-08-12",
      "recordDate": "2024-08-12",
      "payDate": "2024-08-15",
      "agmDate": "2024-04-25",
      "fiscalYear": 2024,
      "fiscalQuarter": 3,
      "exchangeName": "NASDAQ",
      "micCode": "XNAS",
      "reportDate": "2024-06-29",
      "sources": [
        {
          "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/pdf?companyKey=NASDAQ_AAPL",
          "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/page/3/image?companyKey=NASDAQ_AAPL",
          "pageNumber": 3
        }
      ]
    }
  ],
  "forwardDividends": [
    {
      "id": "a1b2c3d4e5f60718",
      "dividendType": "Cash",
      "dividendSubtype": [
        "Scrip"
      ],
      "frequency": "Quarterly",
      "status": "declared",
      "amount": 0.25,
      "distributionRatio": 0.1,
      "amountBasis": "as_declared",
      "currencyCode": "USD",
      "splitAdjFactor": 1,
      "splitAdjAmount": 0.25,
      "adsAdjFactor": 1,
      "adsAdjAmount": 0.25,
      "adsCurrentFactor": 1,
      "shareClassName": "Common Stock",
      "isPrimaryShareClass": true,
      "securityFiscalIdentifier": "FSCLS2URY4YPP321",
      "announceDate": "2024-08-01",
      "exDate": "2024-08-12",
      "recordDate": "2024-08-12",
      "payDate": "2024-08-15",
      "agmDate": "2024-04-25",
      "fiscalYear": 2024,
      "fiscalQuarter": 3,
      "exchangeName": "NASDAQ",
      "micCode": "XNAS",
      "reportDate": "2024-06-29",
      "sources": [
        {
          "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/pdf?companyKey=NASDAQ_AAPL",
          "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/page/3/image?companyKey=NASDAQ_AAPL",
          "pageNumber": 3
        }
      ],
      "expectedAnnounceDate": "2026-11-04"
    }
  ],
  "preferredDividends": [
    {
      "id": "a1b2c3d4e5f60718",
      "dividendType": "Cash",
      "dividendSubtype": [
        "Scrip"
      ],
      "frequency": "Quarterly",
      "status": "declared",
      "amount": 1.5625,
      "distributionRatio": 0.1,
      "amountBasis": "as_declared",
      "currencyCode": "USD",
      "splitAdjFactor": 1,
      "splitAdjAmount": 0.25,
      "adsAdjFactor": 1,
      "adsAdjAmount": 0.25,
      "adsCurrentFactor": 1,
      "shareClassName": "Common Stock",
      "isPrimaryShareClass": true,
      "securityFiscalIdentifier": "FSCLS2URY4YPP321",
      "announceDate": "2024-08-01",
      "exDate": "2024-08-12",
      "recordDate": "2024-08-12",
      "payDate": "2024-08-15",
      "agmDate": "2024-04-25",
      "fiscalYear": 2024,
      "fiscalQuarter": 3,
      "exchangeName": "NASDAQ",
      "micCode": "XNAS",
      "reportDate": "2024-06-29",
      "sources": [
        {
          "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/pdf?companyKey=NASDAQ_AAPL",
          "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/page/3/image?companyKey=NASDAQ_AAPL",
          "pageNumber": 3
        }
      ]
    }
  ],
  "cancellations": [
    {
      "dividendType": "Cash",
      "amount": 0.25,
      "currencyCode": "USD",
      "shareClassName": "Common Stock",
      "announceDate": "2020-04-02",
      "expectedPeriod": "2020-Q2"
    }
  ],
  "periodDps": [
    {
      "periodId": "FY2025",
      "periodType": "Annual",
      "fiscalYear": 2025,
      "fiscalQuarter": 4,
      "reportDate": "2025-12-31",
      "dps": 1,
      "dpsSplitAdj": 1,
      "totalDps": 1.3,
      "totalDpsSplitAdj": 1.3,
      "declaredDps": 1.04,
      "declaredDpsSplitAdj": 1.04,
      "declaredTotalDps": 1.34,
      "declaredTotalDpsSplitAdj": 1.34
    }
  ],
  "annualizedDpsHistory": [
    {
      "date": "2024-06-30",
      "dps": 1,
      "dpsSplitAdj": 1,
      "totalDps": 1.3,
      "totalDpsSplitAdj": 1.3,
      "heldSince": "2024-05-01",
      "basis": "sum"
    }
  ],
  "secondaryDividends": [
    {
      "id": "a1b2c3d4e5f60718",
      "dividendType": "Cash",
      "dividendSubtype": [
        "Scrip"
      ],
      "frequency": "Quarterly",
      "status": "declared",
      "amount": 0.25,
      "distributionRatio": 0.1,
      "amountBasis": "as_declared",
      "currencyCode": "USD",
      "splitAdjFactor": 1,
      "splitAdjAmount": 0.25,
      "adsAdjFactor": 1,
      "adsAdjAmount": 0.25,
      "adsCurrentFactor": 1,
      "shareClassName": "Common Stock",
      "isPrimaryShareClass": true,
      "securityFiscalIdentifier": "FSCLS2URY4YPP321",
      "announceDate": "2024-08-01",
      "exDate": "2024-08-12",
      "recordDate": "2024-08-12",
      "payDate": "2024-08-15",
      "agmDate": "2024-04-25",
      "fiscalYear": 2024,
      "fiscalQuarter": 3,
      "exchangeName": "NASDAQ",
      "micCode": "XNAS",
      "reportDate": "2024-06-29",
      "sources": [
        {
          "document": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/pdf?companyKey=NASDAQ_AAPL",
          "image": "https://api.fiscal.ai/v1/filing/0000320193-24-000081/page/3/image?companyKey=NASDAQ_AAPL",
          "pageNumber": 3
        }
      ],
      "primaryCanonicalId": "a1b2c3d4e5f60718"
    }
  ]
}

Changes

Oct 28, 2026b21561bb5f19 Revision changes
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
Oct 15, 2026d582fea8f51f Revision changes
- info
  endpoint added

Operation history