Skip to main content

Payout Schedule

Retrieve upcoming and historical payout schedules for mutual funds, organized by payout date.

GET/3.0/funds/payout/schedule

Description​

This endpoint returns payout schedules for mutual funds arranged by payout date. It provides information about dividend payouts including the payout amount, payout date, and fund details, helping investors track when they can expect dividend distributions.

Request​

Authentication​

  • Type: Bearer Token
  • Required: Yes

Parameters​

This endpoint does not accept any query parameters.

Response​

Success Response (200)​

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "symbol": "AGCF",
      "name": "Alfalah GHP Fund",
      "payout": 2.5,
      "payout_date": "2025-12-20"
    },
    {
      "symbol": "PKGF",
      "name": "Pakistan Growth Fund",
      "payout": 1.8,
      "payout_date": "2025-12-25"
    },
    {
      "symbol": "INMF",
      "name": "Invest & Grow Fund",
      "payout": 3.2,
      "payout_date": "2026-01-10"
    },
    {
      "symbol": "SCMF",
      "name": "Sarmaya Chuzidon Fund",
      "payout": 2.1,
      "payout_date": "2026-01-15"
    }
  ]
}

Response Fields​

FieldTypeDescription
symbolstringFund symbol / reference identifier
namestringFull name of the mutual fund
payoutnumberDividend payout amount per unit
payout_datestringScheduled payout date (YYYY-MM-DD)

Error Responses​

For detailed Common Error responses, see the Error Handling.

Examples​

Get Payout Schedule for Specific Fund​

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

Use Cases​

  • Payout Planning: Track upcoming dividend payouts for investment planning
  • Income Forecasting: Estimate future dividend income from fund holdings
  • Portfolio Management: Monitor payout schedules across multiple funds
  • Investment Decisions: Choose funds based on payout frequency and amounts
  • Calendar Planning: Plan cash flow based on payout schedules
  • Investor Communication: Inform investors about upcoming dividend payments