Get Raw Statement Data

This endpoint returns a full monthly statement report for a specified financial account in structured JSON format. The report includes account holder details, a summary of financial activity, and a list of individual transactions for the requested period. The period parameter must be set to the first day of the target month.

Endpoint

GET /netevia/rawStatements

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when you need to programmatically retrieve a customer's monthly bank statement data — for example, to render custom statement PDFs, feed data into accounting integrations, or populate reporting dashboards. This is preferable to the PDF statement endpoint when downstream processing or display customization is required. Pass the first day of the target month as the period value.

Query Parameters

Response

200 OK

Top-level statementreport object:

accountSummary object:

financialActivities array item:

{
  "period": "2024-03-01T00:00:00Z",
  "accountHolderName": "Acme Corporation",
  "accountHolderAddress": "123 Business Ave",
  "accountHolderAddressLine2": "Suite 400",
  "accountNumber": "XXXXXXXXXX",
  "routingNumber": "021000021",
  "isBusiness": true,
  "financialAccountId": "fa_9b1c2d3e4f5a6b7c",
  "accountSummary": {
    "beginningBalance": 500000,
    "endingBalance": 612500,
    "deposit": 250000,
    "withdrawal": 100000,
    "fees": 2500,
    "cardTransactions": 35000
  },
  "financialActivities": [
    {
      "id": "act_a1b2c3d4e5f6",
      "type": 1,
      "description": "ACH Deposit - Payroll",
      "amount": 250000,
      "balance": 750000,
      "negative": false,
      "date": "2024-03-05T14:32:00Z",
      "typename": "Deposit",
      "memo": "March payroll funding",
      "fromFinancialAccountId": null,
      "toFinancialAccountId": "fa_9b1c2d3e4f5a6b7c",
      "isMineTransfer": false,
      "fee": null,
      "amountOut": 0,
      "amountIn": 250000,
      "purpose": "Payroll",
      "merchantCategory": null,
      "processingType": "ACH",
      "ledgerEntryId": "led_x1y2z3w4v5"
    },
    {
      "id": "act_b7c8d9e0f1a2",
      "type": 4,
      "description": "Card Purchase - Office Supplies",
      "amount": 12500,
      "balance": 737500,
      "negative": true,
      "date": "2024-03-08T09:15:00Z",
      "typename": "CardTransaction",
      "memo": null,
      "fromFinancialAccountId": "fa_9b1c2d3e4f5a6b7c",
      "toFinancialAccountId": null,
      "isMineTransfer": false,
      "fee": null,
      "amountOut": 12500,
      "amountIn": 0,
      "purpose": "Office Supplies",
      "merchantCategory": "Office Supply Stores",
      "processingType": "Card",
      "ledgerEntryId": "led_p9q8r7s6t5"
    }
  ]
}

Error Codes

Common Mistakes

• Providing a period date that is not the first day of the month — the API expects the month start date (e.g., 2024-03-01T00:00:00Z), not a mid-month date or end-of-month date.
• Omitting the financialAccountId when the authenticated user has multiple financial accounts, which may return unexpected or empty results.
• Interpreting amount, balance, amountIn, and amountOut as dollars — all monetary values are returned in cents (integer); divide by 100 for display.
• Using the negative flag alone to determine debit direction — always cross-reference with amountOut and amountIn for accurate accounting.

Related Endpoints

• GET /netevia/statements — Retrieve statement data in PDF format for a financial account
• GET /netevia/financialAccounts — List all financial accounts for the authenticated customer
• GET /netevia/financialActivities — Retrieve individual transaction activity records outside of a statement context

Example

curl -X GET "https://api.banking.netevia.dev/netevia/rawStatements?financialAccountId=fa_9b1c2d3e4f5a6b7c&period=2024-03-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"