Cash Dividend Data (/fins/dividend)

GET /v2/fins/dividend

Overview

Provides information on dividends (determined and forecast) per share of listed companies, record date, ex-rights date, and payable date.

Attention

Coverage:
- Dividend notifications for issues listed on domestic stock exchanges (TSE, Nagoya, Fukuoka, Sapporo, etc.) are covered. Notifications for issues not listed on the TSE (issues listed only on a regional exchange) are also included.
- For issues that were listed at the time of notification, past data is retained even if the issue is subsequently delisted. A dividend notification may also be recorded under the same issue code after the delisting date, for example when the final dividend of a company that ceased to exist through a share transfer, share exchange, merger, etc. is determined based on the disclosure of the surviving company. See also the FAQ "Can I retrieve data for delisted stocks?".
Types of dividends recorded: Resolutions on year-end, interim, special and commemorative dividends, as well as on no dividend (a dividend amount of 0 yen), are all covered.
Periods and constraints not covered: There is no period or constraint known to be uncovered. However, because the data is created from the disclosure documents of listed companies, a value that does not appear in a disclosure document is not recorded. If such a case comes to light, we will announce it on the Data Correction History and Known issues page or on this page.
Data period: Data is stored from 2013/2/20 onward. This starting point is based on the notification date (PubDate); dividends notified before 2013/2/20 are not carried over into the data. The actual first recorded date differs by issue. For the retrievable period of each plan, see APIs and Data Storage Period by Subscription.
Data ingestion timing: The announcement date and time (PubDate / PubTime) are the date and time at which the information was first provided by JPX Market Innovation and Research, not the time at which the data becomes available on J-Quants. For details, see Data Update Timing of Cash Dividend Data.

We do not provide the date and time when each data item became available on J-Quants. For update frequency and approximate update times, see Update Timing of Provided Data.
Questions we have received about data specifications are also answered in the FAQ (Data & Specs).

Data correction policy

Each dividend notice is assigned a new reference number (RefNo). A correction or deletion is added as a record whose update type (StatCode) is 2 (revised) or 3 (delete), and CARefNo points to the RefNo of the original notice being corrected or deleted.
The pre-correction notices are also retained, so you can follow CARefNo to see which notice corrected or deleted which. See about Reference Number for details.

In this service, we may add or overwrite data due to data deficiencies or omissions. In such cases, the correction history is recorded on Data Correction History and Known issues, so please refer to it.
Note: In these cases, neither the correction history nor pre-correction data is provided via the API, CSV, or other means.

Get dividend data

GET https://api.jquants.com/v2/fins/dividend

Either issue code (code) or date (date) must be specified.

Parameter and Response

Either issue code (code) or date (date) must be specified.
The combination of each parameter and the results of the response are as below.

code	date	from /to	Results
			Cash dividend data for all available period.
			Cash dividend data for a specific issue on the specific date.
			Cash dividend data for a specific issue for the specified period.
			Cash dividend data for all listed issues on the specific date.

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

Either code or date must be specified.

codestringoptional: Issue code
(e.g. 27800 or 2780)
If a 4-character issue code is specified, only the data of common stock will be obtained for the issue on which both common and preferred stocks are listed.
fromstringoptional: Starting point of data period (e.g. 20210901 or 2021-09-01)
tostringoptional: End point of data period (e.g. 20210907 or 2021-09-07)
datestringoptional: When "from" and "to" are not specified (e.g. 20210907 or 2021-09-07)
pagination_keystringoptional: The primary key of the first item that this operation will evaluate.
Use the value that was returned for pagination_key in the previous operation.

Sample Code

Request

GET

/v2/fins/dividend

curl -G https://api.jquants.com/v2/fins/dividend \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="2024-10-25"

Responses

Data Item

PubDatestring: Announcement Date (YYYY-MM-DD)
The date (JST) on which the information was first provided by JPX Market Innovation and Research.
PubTimestring: Announcement Time (HH:MM)
The time (JST) at which the information was first provided by JPX Market Innovation and Research.
Codestring: Issue code
RefNostring: Reference Number
Number to uniquely identify the dividend notification
Reference numbers are assigned sequentially, but this item is not intended for determining the order of announcements.
See about Reference Number
StatCodestring: Status Code
1: new, 2: revised, 3: delete
BoardDatestring: Date of Board of Directors' resolution
IFCodestring: Interim/Final Code
1: interim, 2: final
FRCodestring: Forecast/Result Code
1: result, 2: forecast
Forecasts and results are provided as separate series of notices. See about Reference Number
IFTermstring: Interim Final Term
DivRatenumber / string: Dividend value per share (in Japanese yen, per share)
0 if no dividend, "-" if undetermined, "" if not applicable.
・If the listed company discloses only the annual total without distinguishing between interim and year-end dividends, the value is output as undetermined ("-").
・When a stock split or reverse split takes place, each dividend amount is stated on the basis of the number of shares as of its record date (pre-split basis if the dividend record date is on or before the record date of the split or reverse split; post-split basis if it is after).
・Records already notified are not retroactively restated for the split or reverse split.
・If a dividend forecast with a post-split record date had been notified before the split or reverse split was announced, it is normally updated to the post-split basis by a correction notice (StatCode = 2) at the time of the announcement.
・Distributions of ETFs (beneficiary certificates), REITs and infrastructure funds (investment securities) are also recorded in this item.
RecDatestring: Record date
ExDatestring: Ex-rights date
ActRecDatestring: Date of Dividend Vesting
PayDatestring: Scheduled payment start date
"-" if undetermined, "" if not applicable.
CARefNostring: CA Reference Number
Reference number of the dividend notice of modification or deletion. For new notification, same value as Reference number.
See about Reference Number
DistAmtnumber / string: Amount of cash delivered per share
"-" if undetermined, "" if not applicable.
Provides only after February 24, 2014.
RetEarnnumber / string: Retained earnings per share
"-" if undetermined, "" if not applicable.
Provides only after February 24, 2014.
DeemDivnumber / string: Deemed dividend per share
"-" if undetermined, "" if not applicable.
Provides only after February 24, 2014.
DeemCapGainsnumber / string: Amount of deemed transfer income per share
"-" if undetermined, "" if not applicable.
Provides only after February 24, 2014.
NetAssetDecRationumber / string: Decrease ratio in net assets
"-" if undetermined, "" if not applicable.
Provides only after February 24, 2014.
CommSpecCodestring: Code stands for Commemorative/Special dividend
1: Commemorative, 2: Special, 3: Both, 0: Normal
CommDivRatenumber / string: Commemorative dividend value per share
"-" if undetermined, "" if not applicable.
Provides only after June 6, 2022.
SpecDivRatenumber / string: Special dividend value per share
"-" if undetermined, "" if not applicable.
Provides only after June 6, 2022.

Response Sample

{
    "data": [
        {
            "PubDate": "2014-02-24",
            "PubTime": "09:21",
            "Code": "15550",
            "RefNo": "201402241B00002",
            "StatCode": "1",
            "BoardDate": "2014-02-24",
            "IFCode": "2",
            "FRCode": "2",
            "IFTerm": "2014-03",
            "DivRate": "-",
            "RecDate": "2014-03-10",
            "ExDate": "2014-03-06",
            "ActRecDate": "2014-03-10",
            "PayDate": "-",
            "CARefNo": "201402241B00002",
            "DistAmt": "",
            "RetEarn": "",
            "DeemDiv": "",
            "DeemCapGains": "",
            "NetAssetDecRatio": "",
            "CommSpecCode": "0",
            "CommDivRate": "",
            "SpecDivRate": ""
        }
    ],
    "pagination_key": "value1.value2."
}