Sign in
latestOpenAPI 3.0.32026-08-101461131.1 MB

ad6f143e43aa

us_stocks_reference

Contains historical dividend payment records for US stocks with split-adjusted amounts and historical adjustment factors for price normalization.

get/stocks/v1/dividends

Query parameters

tickerstring

Stock symbol for the company issuing the dividend

ticker.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

ticker.gtstring

Filter greater than the value.

ticker.gtestring

Filter greater than or equal to the value.

ticker.ltstring

Filter less than the value.

ticker.ltestring

Filter less than or equal to the value.

ex_dividend_datestring

Date when the stock begins trading without the dividend value Value must be formatted 'yyyy-mm-dd'.

ex_dividend_date.gtstring

Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.

ex_dividend_date.gtestring

Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

ex_dividend_date.ltstring

Filter less than the value. Value must be formatted 'yyyy-mm-dd'.

ex_dividend_date.ltestring

Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

frequencyinteger

How many times per year this dividend is expected to occur. A value of 0 means the distribution is non-recurring or irregular (e.g., special, supplemental, or a one-off dividend). Other possible values include 1 (annual), 2 (semi-annual), 3 (trimester), 4 (quarterly), 12 (monthly), 24 (bi-monthly), 52 (weekly), 104 (bi-weekly), and 365 (daily) depending on the issuer's declared or inferred payout cadence. Value must be an integer.

frequency.gtinteger

Filter greater than the value. Value must be an integer.

frequency.gteinteger

Filter greater than or equal to the value. Value must be an integer.

frequency.ltinteger

Filter less than the value. Value must be an integer.

frequency.lteinteger

Filter less than or equal to the value. Value must be an integer.

distribution_type'recurring' | 'special' | 'supplemental' | 'irregular' | 'unknown'

Classification describing the nature of this dividend's recurrence pattern: recurring (paid on a regular schedule), special (one-time or commemorative), supplemental (extra beyond the regular schedule), irregular (unpredictable or non-recurring), unknown (cannot be classified from available data)

distribution_type.any_of'recurring' | 'special' | 'supplemental' | 'irregular' | 'unknown'

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

limitinteger

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '5000'.

sortstring

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'ticker' if not specified. The sort order defaults to 'asc' if not specified.

Response

A list of results.

next_urlstring

If present, this value can be used to fetch the next page.

request_idstring required

A request id assigned by the server.

status'OK' required

The status of this request's response.