Annual Cashflow Statement

Retrieve annual cash flow statement data for a specific company.

GET/3.0/company/financials/cashflow/annual

Description

This endpoint returns annual cash flow statement data including operating, investing, and financing cash flows for a specific company. Provides detailed breakdown of cash movements, sources, and uses on an annual basis.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
symbol	string	Yes	Stock symbol/ticker code for the company	DGKC

Response

Success Response (200)

{
    "status": "ok",
    "message": "",
    "data": {
        "symbol": "HBL",
        "created": "2025-06-17T10:13:23.657Z",
        "interval": "annual",
        "consolidated": false,
        "type": "cashflow",
        "periods": [
            {
                "year": "2024",
                "period_end": "2024-12-31",
                "year_end_diff": 12
            },
            {
                "year": "2023",
                "period_end": "2023-12-31",
                "year_end_diff": 12
            }
        ],
        "fields": [
            {
                "label": "Profit before taxation",
                "values": [
                    118877106,
                    111737068
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Depreciation on fixed assets ",
                "values": [
                    14022306,
                    12711972
                ],
                "is_heading": false,
                "key": "dep_fa"
            },
            {
                "label": "Amortization ",
                "values": [
                    2562560,
                    2104309
                ],
                "is_heading": false,
                "key": "amort"
            },
            {
                "label": "Working capital changes ",
                "values": [
                    -84430588,
                    630266945
                ],
                "is_heading": false,
                "key": "wor_capc"
            },
            {
                "label": "Cash generated from operating activities",
                "values": [
                    60512773,
                    764872606
                ],
                "is_heading": false,
                "key": "cash_gen_oa"
            },
            {
                "label": "Income tax paid",
                "values": [
                    -93513741,
                    -50032776
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Net cash flows from operating activities",
                "values": [
                    -33000968,
                    714839830
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Proceeds from sale of fixed assets",
                "values": [
                    539538,
                    212390
                ],
                "is_heading": false,
                "key": "pro_sale_fa"
            },
            {
                "label": "Net cash flow used in investing activities",
                "values": [
                    -17495732,
                    -433705965
                ],
                "is_heading": false,
                "key": "net_cf_ia"
            },
            {
                "label": "Dividend paid",
                "values": [
                    -25265428,
                    -12358209
                ],
                "is_heading": false,
                "key": "div_paid"
            },
            {
                "label": "Net cash flows from financing activities ",
                "values": [
                    -34511131,
                    -21627007
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Increase/ (decrease) in cash and cash equivalents",
                "values": [
                    -85007831,
                    259506858
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Cash and cash equivalents at beginning of the year",
                "values": [
                    568086861,
                    291129069
                ],
                "is_heading": false,
                "key": null
            },
            {
                "label": "Cash and cash equivalents at end of the year",
                "values": [
                    463186252,
                    548194083
                ],
                "is_heading": false,
                "key": null
            }
        ]
    }
}

Response Fields

Field	Type	Description
symbol	string	Company stock symbol
created	string	Data creation timestamp (ISO 8601 format)
interval	string	Reporting interval (quarterly, annual)
consolidated	boolean	Whether financials are consolidated
type	string	Type of financial statement (income, balance, cash_flow)
periods	array	Array of reporting periods View
fields	array	Array of financial line items View

Periods Array Fields

Field	Type	Description
year	string	Fiscal year
period_end	string	Period end date (YYYY-MM-DD)
year_end_diff	integer	Month difference from year end

Fields Array Fields

Field	Type	Description
label	string	Line item label/description
values	array	Array of values corresponding to each period
is_heading	boolean	Whether this is a section heading
key	string	Machine-readable key for the line item

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Symbol (200)

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

Examples

Get Annual Cash Flow Statement

curl -X GET "https://csapis.com/3.0/company/financials/cashflow/annual?symbol=DGKC" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Cash Flow Analysis: Evaluate company's cash generation ability
• Liquidity Assessment: Assess operating cash flow vs capital needs
• Investment Evaluation: Analyze cash available for dividends and debt repayment
• Quality of Earnings: Compare net income to operating cash flow
• Capital Allocation: Track capital expenditure and financing activities
• Cash Flow Trends: Monitor multi-year cash flow patterns
• Forecasting: Use historical cash flows for future cash flow projections