Fetch Bank Statements

GET /v1/connected_banking/statements

Returns the bank statement for a given account and date range.

See the Partner bank list for the full partner_bank_id → bank mapping.

HDFC special case (partner_bank_id = 8): statements are fetched asynchronously from the bank. The initial call returns only a request_id and HTTP 202 Accepted. Once the statement is ready, Open notifies your webhook (5.3.3); you then call List HDFC Statements by request_id (5.3.2) to fetch the data.

All other banks: statements are returned inline in this single call.

Query parameters

Param	Required	Notes
`from_date`	yes	`YYYY-MM-DD`
`sub_merchant_id`	yes	The sub-merchant reference id
`to_date`	yes	`YYYY-MM-DD`. Maximum window is 30 days.
`bank_account_id`	yes	Open's UUID for the merchant's account
`cursor`	no	Pagination cursor (ignored for HDFC initial fetch)
`limit`	no	Page size, default `25`, max `100` (ignored for HDFC initial fetch)

Success (non-HDFC) — 200 OK

{
    "status": "success",
    "data": {
        "bank_account_id": "d88a2124-fdeb-414d-b836-418ee28e31c6",
        "request_id": "d0a9f4e3-670a-4247-86c0-d23caa710ea4",
        "statements": [
            {
                "transaction_id": "S64016590",
                "transaction_amount": "20.05",
                "transaction_type": "debit",
                "closing_balance": "10831.56",
                "transacted_date": "2026-06-12 18:02:41",
                "posted_date": "2026-06-12 18:02:41",
                "value_date": "2026-06-12 00:00:00",
                "reference_number": "142422444",
                "remarks": "NBSM/142422444/OPEN FINANCIAL TECHNOLOGIES PVT LT"
            },
            {
                "transaction_id": "S60811114",
                "transaction_amount": "1.00",
                "transaction_type": "credit",
                "closing_balance": "10851.61",
                "transacted_date": "2026-06-12 17:04:46",
                "posted_date": "2026-06-12 17:04:46",
                "value_date": "2026-06-12 00:00:00",
                "reference_number": "6163211105812",
                "remarks": "NEFT/YESF261636154667/OPEN FINANCIAL TECHNOLOGIES/YES BANK/Test Two"
            },
            {
                "transaction_id": "S60285818",
                "transaction_amount": "20.02",
                "transaction_type": "debit",
                "closing_balance": "10850.61",
                "transacted_date": "2026-06-12 16:54:31",
                "posted_date": "2026-06-12 16:54:31",
                "value_date": "2026-06-12 00:00:00",
                "reference_number": "142411185",
                "remarks": "NBSM/142411185/OPEN FINANCIAL TECHNOLOGIES PVT LT"
            },
            {
                "transaction_id": "C47417982",
                "transaction_amount": "1.00",
                "transaction_type": "credit",
                "closing_balance": "10870.63",
                "transacted_date": "2026-06-04 04:24:48",
                "posted_date": "2026-06-04 04:24:48",
                "value_date": "2026-06-04 00:00:00",
                "reference_number": "614420820926",
                "remarks": "NEFT/YESF1111550006472/OPEN FINANCIAL TECHNOLOGIES/YES BANK/Test Two"
            }
        ]
    },
    "error": null,
    "meta": {
        "timestamp": "2026-07-23T11:14:21.27751644Z",
        "pagination": {
            "cursor": null,
            "next_cursor": null,
            "limit": 25,
            "has_more": false
        }
    }
}

Success (HDFC, partner_bank_id = 8) — 202 Accepted

{
  "status": "success",
  "data": {
    "bank_account_id": "a7973e36-ad33-5de9-86d0-c448d8f47e87",
    "request_id": "f4e8b2a1-9c0d-4a1e-9b2c-7d6e5f4a3b21",
    "statements": null
  },
  "error": null,
  "meta": { "timestamp": "2026-04-15T12:00:00Z" }
}

request_id is always returned for every bank — store it for reference / reconciliation.

Possible errors: OPN_CB_ST_001, OPN_CB_ST_002, OPN_CB_ST_003, OPN_CB_ST_004, OPN_CB_ST_007