All Payouts by Symbol

Retrieve all payout information (dividends, splits, bonus, rights) for a specific stock symbol.

GET/3.0/payouts

Description

This endpoint returns comprehensive payout information for a specified stock symbol, including dividend payments, stock splits, bonus shares, and rights issues. It provides historical payout records with dates, amounts, and ratios for informed investment decisions.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
symbol	string	Yes	Stock symbol/ticker code	EFERT

Response

Success Response (200)

{
    "status": "ok",
    "message": "",
    "data": [
        {
            "id": "247066",
            "title": "Financial results for Year ended December 31, 2024",
            "form_type": "FRYEV1003",
            "quarter": "YEAR",
            "period_ended": "2024-12-31",
            "date": "2025-02-10T03:01:15Z",
            "pdf": "",
            "docs": [
                "247066.pdf"
            ],
            "images": [
                "247066-1.gif"
            ],
            "payouts": {
                "book_closure_from": "2025-03-18",
                "book_closure_to": "2025-03-24",
                "entitlement_date": "2025-03-17",
                "ex_date": "2025-03-14",
                "dividend": 8,
                "bonus": 0,
                "right_price": 0,
                "right_issue": 0,
                "split_num": 0,
                "split_den": 0,
                "rsplit_num": 0,
                "rsplit_den": 0,
                "sdiv_num": 0,
                "sdiv_den": 0
            }
        },
        {
            "id": "251697",
            "title": "Financial results for Q1 ended March 31, 2025",
            "form_type": "FRV1007",
            "quarter": "Q1",
            "period_ended": "2025-03-31",
            "date": "2025-04-22T03:02:16Z",
            "pdf": "",
            "docs": [
                "251697.pdf"
            ],
            "images": [
                "251697-1.gif"
            ],
            "payouts": {
                "book_closure_from": "2025-05-05",
                "book_closure_to": "2025-05-06",
                "entitlement_date": "2025-05-02",
                "ex_date": "2025-04-30",
                "dividend": 2.25,
                "bonus": 0,
                "right_price": 0,
                "right_issue": 0,
                "split_num": 0,
                "split_den": 0,
                "rsplit_num": 0,
                "rsplit_den": 0,
                "sdiv_num": 0,
                "sdiv_den": 0
            }
        }
    ]
}

Response Fields

Data Array Fields

Field	Type	Description
id	string	Payout announcement ID
title	string	Payout announcement title
form_type	string	Form type designation
quarter	string	Quarter designation if applicable
period_ended	string	Period end date if applicable
date	string	Announcement publication date (ISO 8601 format)
pdf	string	Primary PDF document filename
docs	array	Array of document filenames
images	array	Array of image filenames (if any)
payouts	object	Payout details including dividends and bonus View

Payouts Object Fields

Field	Type	Description
book_closure_from	string	Book closure start date
book_closure_to	string	Book closure end date
entitlement_date	string	Entitlement date for dividend/bonus
ex_date	string	Ex-dividend/ex-bonus date
dividend	number	Dividend amount per share
bonus	number	Bonus ratio (bonus shares)
right_price	number	Rights issue price
right_issue	number	Rights issue ratio
split_num	number	Stock split numerator
split_den	number	Stock split denominator
rsplit_num	number	Reverse split numerator
rsplit_den	number	Reverse split denominator
sdiv_num	number	Specie dividend numerator
sdiv_den	number	Specie dividend denominator

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Symbol (200)

{
  "status": "error",
  "message": "no 'symbol' provided"
}

Examples

Get All Payouts

curl -X GET "https://csapis.com/3.0/payouts?symbol=EFERT" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Dividend Tracking: Monitor dividend payments and ex-dates
• Corporate Action History: Track all corporate actions (splits, bonus, rights) for a stock
• Investment Analysis: Analyze payout history for dividend growth and consistency
• Tax Planning: Plan for upcoming dividend payments and tax implications
• Valuation Models: Include historical payouts in dividend discount models
• Rights Issue Tracking: Monitor and track rights offerings