---
title: "GET /bankTransactions"
method: GET
path: "/bankTransactions"
tags: ["Bank Transactions"]
---

# GET /bankTransactions

`GET /bankTransactions`

Gets the latest bank transactions from a banking service provider for a business.

## Query parameters

- `businessName` string, required
- `serviceName` 'plaid', required
- `offset` number
- `limit` number
- `orderBy` string
- `startDate` string
- `endDate` string

## Response `200`

- GetBankTransactionsResponseDto
  - `pagination` PaginationMetaData, required
    - `offset` number, required
    - `limit` number, required
    - `count` number, required
  - `count` integer, required
  - `reports` BankTransactionsReport[], required
    - `meta` BankTransactionsReportMetaData, required
      - `reportId` string, required
      - `serviceName` 'quickbooks' | 'xero' | 'freshbooks' | 'quickbooksDesktop' | 'sageIntacct' | 'sageBusinessCloud' | 'oracleNetsuite' | 'dynamicsBusinessCentral' | 'dynamics365Finance' | 'wave' | 'zohoBooks' | 'myob', required
      - `businessName` string, required
      - `startDate` string, required
      - `endDate` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `data` GetBankTransactionsData[], required
      - `id` string, required
      - `accountId` string, required
      - `date` string, date-time, required
      - `authorizedOnDate` string, date-time
      - `isPending` boolean, required
      - `amount` number, float, required
      - `currency` string, required
      - `transactionType` 'adjustment' | 'atm' | 'bankCharge' | 'billPayment' | 'cash' | 'cashback' | 'cheque' | 'directDebit' | 'interest' | 'purchase' | 'standingOrder' | 'transfer'
      - `paymentChannel` 'online' | 'inStore' | 'other', required
      - `categories` string[]
      - `merchantName` string
      - `merchantStoreNumber` string
      - `description` string, required
      - `location` BankLocationData
        - `line1` string
        - `line2` string
        - `city` string
        - `region` string
        - `country` string
        - `postalCode` string
      - `section` 'Assets' | 'Expenses' | 'Income' | 'Liabilities' | 'Equity'
      - `subSection` 'Current Assets' | 'Non-Current Assets' | 'Current Liabilities' | 'Non-Current Liabilities' | 'Equity' | 'Income' | 'Other Income' | 'Operating Expenses' | 'Other Expenses' | 'Cost of Goods Sold'
      - `group` string
      - `subGroup` string

## Other responses

- `202` — Data in pending state
- `204` — No data available
- `400` — Bad Request Error - Thrown if fields sent via query does not follow specifications
- `401` — Unauthorized - Not logged in or log in expired
- `403` — Forbidden - Not enough permission
- `500` — Server Error

---

[API](https://skmtc.net/railz/apis/fis-accounting-data-as-a-service-api.md) · [All operations](https://skmtc.net/railz/apis/fis-accounting-data-as-a-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/railz/fis-accounting-data-as-a-service-api/revisions/5cdfae3fa1fa/schema)