Payouts by Fund

Retrieve historical dividend payout information for mutual funds.

GET/3.0/funds/payouts

Description

This endpoint returns historical dividend payout data for mutual funds, including payout amounts and ex-dividend NAV values. You can query for a date range or filter by specific fund IDs.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Parameter	Type	Required	Description
fund_id	string	Yes	Specific fund identifier, UUID (see All Funds Overview for available funds)
date_from	string	Yes	Start date for date range in RFC3339 format
date_to	string	Yes	End date for date range in RFC3339 format

Note: At least one parameter must be provided (fund_id, or both date_from and date_to).

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "payout_date": "2025-10-15",
      "fund_id": "2602024a-9498-4898-ad61-eafc66dbe09a",
      "value": 2.5,
      "ex_nav": 517.8
    },
    {
      "payout_date": "2025-07-15",
      "fund_id": "2602024a-9498-4898-ad61-eafc66dbe09a",
      "value": 2.2,
      "ex_nav": 515.3
    }
  ]
}

Response Fields

Field	Type	Description
payout_date	string	Payout date (YYYY-MM-DD)
fund_id	string	Fund identifier (UUID)
value	number	Dividend payout amount per unit
ex_nav	number	Ex-dividend Net Asset Value per unit

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing params (200)

{
  "status": "error",
  "message": "no `param` provided"
}

Examples

Get Payouts for Specific Fund

curl -X GET "https://csapis.com/3.0/funds/payouts?fund_id=2602024a-9498-4898-ad61-eafc66dbe09a" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Dividend Tracking: Monitor dividend payments and ex-dividend dates
• Income Analysis: Analyze fund dividend yield and payout history
• Portfolio Income: Calculate dividend income for portfolio holdings
• Performance Attribution: Understand impact of dividends on fund returns
• Tax Planning: Track dividend payments for tax reporting purposes