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

Stocks that are not listed on the TSE (including issue listed only on the other exchanges) are not included in the data.

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)
PubTimestring: Announcement Time (HH:MM)
Codestring: Issue code
RefNostring: Reference Number
Number to uniquely identify the dividend notification
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
IFTermstring: Interim Final Term
DivRatenumber / string: Dividend value per share
"-" if undetermined, "" if not applicable.
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."
}