Bank Statement AnalysisDownload Report

Download Bank Statement Analysis Report

Download the analyzed bank statement report with categorized transactions, income summary, and spending patterns in JSON or PDF format.

curl -X GET "https://production.deepvue.tech/v1/bsa/download-report?reference_id=example_string&report_type=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
  -H "x-api-key: YOUR_API_KEY"
{
  "code": 200,
  "timestamp": 1743779806782,
  "transaction_id": "8d42f493eb16402bad2b7ad9e7f215d8",
  "sub_code": "SUCCESS",
  "message": "File processing completed",
  "data": {
    "url": "https://deepvue-tech.s3.ap-south-1.amazonaws.com/333e8ab-91fc-4291-8dc8-29c89373b9e4_BSA_Report.xlsx"
  }
}
GET
/v1/bsa/download-report
GET
Bearer Token (JWT)
Bearer Tokenstring
Required

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key (header: x-api-key)
x-api-keystring
Required

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

header
x-api-keystring
Required

API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

Query Parameters

Responses

codeinteger
timestampinteger
transaction_idstring
sub_codestring
messagestring
dataobject

Overview

This API retrieves the analyzed bank statement report in either XLSX or JSON format after document processing has been completed. You provide a reference ID (obtained from the Upload API) and specify your desired report format.

The analysis data includes:

  • Monthly financial overview and transaction breakdowns
  • Income and expense categorization
  • Account holder details and statement period information
  • Complete bank statement line items with transaction classifications
  • End-of-day (EOD) balance analysis by month
  • Top 10 debit and credit transactions
  • Exceptional transaction flagging (weekend activity, high-value transfers, etc.)
  • Cheque and online return tracking
  • ECS/NACH transaction details
  • Investment transaction history
  • Related party transaction identification

Processing states

The API returns different responses based on the current processing status:

  • Completed -- full report data is available for download or JSON consumption.
  • In Progress -- processing continues; check again later.
  • Failed -- processing encountered errors; the reference ID may be invalid.

You need an authorized access token to access any of the Platform APIs. One access token is valid for only 24 hours. After expiration, you can renew the token by using the Authorize endpoint to receive a fresh access token.