Pricing Blog Insights Playground
Dashboard

Upcoming dividends

GET/api/earnings/upcoming-dividends

Stock Pro

Declared dividends with an ex-dividend date in the next N days (default 7, max 28), sorted by ex-date ascending. Covers common stocks with an active listing; fund and ETF distributions are not included. Each entry is one dividend event: ex-date, payment/record/announcement dates when declared, dividend per share, and the indicated annual dividend. Delisted companies (no active listing on any exchange) are excluded.

Amounts are declared in USD. When a different currency is requested, dividendPerShare and indicatedAnnualDividend are converted using the most recent available exchange rate (the events are in the future, so no historical rate exists yet); the currency field states the currency of the returned amounts.

Get API key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/earnings/upcoming-dividends?days=7&page=1&pageSize=50&currency=USD' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Paginated list of upcoming dividend events.

Response schema

  • page integer

    Current page number (1-indexed).

  • pageSize integer

    Number of results per page.

  • totalPages integer

    Total number of pages.

  • totalResults integer

    Total dividend events in the window.

  • data array of object
    array of:
    • symbols array of string

      All active tickers for the entity, primary first. A multi-class issuer is a single entry with all classes.

    • name string

      Issuer name (SEC conformed form).

    • exDate string

      Ex-dividend date (YYYY-MM-DD). Shares bought on or after this date do not receive the dividend.

    • paymentDate string | null

      Payment date (YYYY-MM-DD). Null when not yet declared.

    • recordDate string | null

      Record date (YYYY-MM-DD). Null when not yet declared.

    • announcementDate string | null

      Declaration date (YYYY-MM-DD). Null when unavailable.

    • dividendPerShare number | null

      Declared dividend per share for this event, in the returned `currency`.

    • indicatedAnnualDividend number | null

      Indicated annual dividend per share (declared amount annualized by payment frequency), in the returned `currency`.

    • currency string

      Currency of the returned amounts. Echoes the requested target currency; USD when no conversion applies.

Example response

{
  "page": 1,
  "pageSize": 50,
  "totalPages": 3,
  "totalResults": 142,
  "data": [
    {
      "symbols": [
        "MO"
      ],
      "name": "Altria Group, Inc.",
      "exDate": "2026-08-25",
      "paymentDate": "2026-09-10",
      "recordDate": "2026-08-25",
      "announcementDate": "2026-07-24",
      "dividendPerShare": 1.06,
      "indicatedAnnualDividend": 4.24,
      "currency": "USD"
    }
  ]
}

400 Bad Request

Invalid parameters

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

{}