---
title: "Get transactions for a specific Account"
method: GET
path: "/accounts/{accountId}/transactions"
tags: ["Transactions"]
---

# Get transactions for a specific Account

`GET /accounts/{accountId}/transactions`

Retrieves the last 6 months of transactions (successful payments in & out) of an account, specified by a unique account reference.

## Path parameters

- `accountId` string, required

## Query parameters

- `q` string — Partial description text to search for
- `minAmount` number — Transactions with amount equal or more than this amount
- `maxAmount` number — Transactions with amount equal or less than this amount
- `fromPostedDate` string — Transactions with posted date equal or after to this date
- `toPostedDate` string — Transactions with posted date equal or before to this date. Format is 'yyyy-MM-dd'T'HH:mm:ssZ' where Z is UTC offset. e.g 2017-01-28T01:01:01+0000
- `type` string[] — Transaction types
- `credit` boolean — If true only credit transactions will be returned, if false, only debit transactions will be returned
- `sourceId` string — Transactions with this sourceId
- `size` integer — Size of Page to fetch
- `showAvailableBalance` boolean — Show available balance
- `fromTransactionDate` string — Transactions with transaction date equal or after to this date. Format is 'yyyy-MM-dd'T'HH:mm:ssZ' where Z is UTC offset. e.g 2017-01-28T01:01:01+0000
- `toTransactionDate` string — Transactions with transaction date equal or before to this date. Format is 'yyyy-MM-dd'T'HH:mm:ssZ' where Z is UTC offset. e.g 2017-01-28T01:01:01+0000
- `page` integer — Page to fetch (0 indexed)

## Response `200`

OK

- AccountTransactionPageResponse
  - `content` AccountTransactionResponse[] — List of responses on the current page
    - `id` string — Unique id for the Transaction
    - `amount` number — Amount of the transaction in Major Currency Units
    - `currency` string — Currency of the account in ISO 4217 format
    - `description` string — Description of the transaction. Contains Payer/ Payee details and reference
    - `transactionDate` string, date-time — Datetime when the transaction took place. Format is 'yyyy-MM-dd'T'HH:mm:ssZ' where Z is UTC offset. e.g 2017-01-28T01:01:01+0000
    - `postedDate` string, date-time — Datetime when the transaction was posted to the Modulr system. Format is 'yyyy-MM-dd'T'HH:mm:ssZ' where Z is UTC offset. e.g 2017-01-28T01:01:01+0000
    - `credit` boolean — Indicates if the transaction was a Credit or a Debit
    - `type` string — Enumerated type indicating the type of the transaction
    - `sourceId` string
    - `sourceExternalReference` string
    - `additionalInfo` unknown
    - `account` AccountAccountResponse — Account
      - `id` string — Unique id for the account
      - `name` string — Name for the account
      - `balance` string — Balance of the account in format 'NN.NN'
      - `availableBalance` string — The current available balance of the Account. Calculated by subtracting any pending payments from the current balance
      - `currency` string — Currency of the account in ISO 4217 format
      - `status` string — Status of the account. Accounts must be 'ACTIVE' to make and receive payments. Can be one of
      - `identifiers` AccountIdentifierResponse[]
        - `type` string
        - `accountNumber` string — Bank account Sort Code
        - `accountType` 'PERSONAL' | 'BUSINESS' — Bank account type like PERSONAL/BUSINESS
        - `sortCode` string — Bank account Sort Code
        - `iban` string
        - `bic` string
        - `currency` string
        - `countrySpecificDetails` AccountIdentifierCountrySpecificDetailsResponse
          - `bankName` string — The name of the destination bank.
          - `bankAddress` string — The address of the destination bank.
          - `bankCity` string — The city in which the destination bank resides.
          - `bankBranchName` string — The name of the destination bank's branch.
          - `bankBranchCode` string — The code of the destination bank's branch.
          - `bankCode` string — The code identifying the target bank on its respective national network. This is not the BIC/SWIFT code. This is known as the 'ABA code' in the U.S., 'ISFC' in India, 'routing number' in Canada, and so on.
          - `chineseId` string — The 18 digit identification code of the beneficiary. Applies to Chinese beneficiaries only.
          - `province` string — The province in which the beneficiary resides. Applies only to beneficiaries residing in China.
          - `business` boolean — The type of the beneficiary. 'true' for businesses, 'false' otherwise.
          - `bankCodeType` 'ABA' | 'CHIPS' — The code type identifying the target bank on its respective national network. This is known as the 'ABA code' in the U.S., 'ISFC' in India, 'routing number' in Canada, and so on.
          - `bankCountry` 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DK' | 'EE' | 'FI' | 'FR' | 'DE' | 'GR' | 'HR' | 'HU' | 'IS' | 'IE' | 'IT' | 'LV' | 'LI' | 'LT' | 'LU' | 'MT' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'SK' | 'SI' | 'ES' | 'SE' | 'GB' | 'MQ' | 'YT' | 'GP' | 'GF' | 'RE' | 'MF' | 'GI' | 'GG' | 'IM' | 'JE' | 'MC' | 'CH' | 'AD' | 'SM' | 'VA' | 'AX' | 'PM' | 'BL' | 'AL' | 'MD' | 'ME' | 'MK' | 'RS' | 'AF' | 'DZ' | 'AS' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BQ' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'VG' | 'BN' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CK' | 'CR' | 'CU' | 'CW' | 'CD' | 'DJ' | 'DM' | 'DO' | 'TL' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'GH' | 'GL' | 'GD' | 'GU' | 'GT' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'HN' | 'HK' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IL' | 'CI' | 'JM' | 'JP' | 'JO' | 'KZ' | 'KE' | 'KI' | 'XK' | 'KW' | 'KG' | 'LA' | 'LB' | 'LS' | 'LR' | 'LY' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MH' | 'MR' | 'MU' | 'MX' | 'FM' | 'MN' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'AN' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'KP' | 'MP' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PR' | 'QA' | 'CG' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'VC' | 'WS' | 'ST' | 'SA' | 'SN' | 'SC' | 'SL' | 'SG' | 'SX' | 'SB' | 'SO' | 'ZA' | 'KR' | 'GS' | 'SS' | 'LK' | 'SD' | 'SR' | 'SY' | 'SJ' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'UM' | 'US' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' — The country in which the destination bank resides.
          - `abaRoutingNumber` string — The 9 digit identification code of the beneficiary. Applies to US beneficiaries only.
        - `productId` string
      - `customerId` string — Unique id of the Customer
      - `customerName` string — Customer Name
      - `externalReference` string — Your reference for an account
      - `accessGroups` string[] — Ids of Access Groups this account belongs to
      - `createdDate` string, date-time — Datetime when the account was created. Format is 'yyyy-MM-dd'T'HH:mm:ssZ' where Z is UTC offset. e.g 2017-01-28T01:01:01+0000
      - `directDebit` boolean — Direct Debit Enabled
      - `securedFundingLimit` string — Limit of funds available below a balance of zero
  - `size` integer — Page size
  - `totalSize` integer — Total count
  - `page` integer — Current page number, 0 based; i.e first-page = 0, second-page = 1
  - `totalPages` integer — Total pages
  - `pageStartBalance` number — The sum of the transactions up to this page. This is only present if there are no filters other than page and size defined

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/versions/cbd52524c8ef/schema)