---
title: "GET /api/v2/accounts/{id}/transactions/"
method: GET
path: "/api/v2/accounts/{id}/transactions/"
tags: ["accounts"]
---

# GET /api/v2/accounts/{id}/transactions/

`GET /api/v2/accounts/{id}/transactions/`

## Request

- Base URL: `https://bankaccountdata.gocardless.com`
- URL: `https://bankaccountdata.gocardless.com/api/v2/accounts/{id}/transactions/`
- Auth: HTTP bearer

Access account transactions.

Transactions will be returned in Berlin Group PSD2 format.

## Path parameters

- `id` string, required

## Query parameters

- `date_from` string, date
- `date_to` string, date

## Response `200`

Sample account transactions

- AccountTransactions: AccountTransactionsSerializer.
  - `transactions` BankTransaction, required: BankTransactionSerializer.
    - `booked` TransactionSchema[], required
      - `transactionId` string: transactionId
      - `entryReference` string: entryReference
      - `endToEndId` string: endToEndId
      - `mandateId` string: mandateId
      - `checkId` string: checkId
      - `creditorId` string: creditorId
      - `bookingDate` string: bookingDate
      - `valueDate` string: valueDate
      - `bookingDateTime` string: bookingDateTime
      - `valueDateTime` string: valueDateTime
      - `transactionAmount` TransactionAmountSchema, required: TransactionAmountSchema.
        - `amount` string, required: amount
        - `currency` string, required: currency
      - `currencyExchange` CurrencyExchangeSchema[]
        - `sourceCurrency` string: sourceCurrency
        - `exchangeRate` string: exchangeRate
        - `unitCurrency` string: unitCurrency
        - `targetCurrency` string: targetCurrency
        - `quotationDate` string: quotationDate
        - `contractIdentification` string: contractIdentification
      - `creditorName` string: creditorName
      - `creditorAccount` AccountSchema: AccountSchema.
        - `iban` string: iban
        - `bban` string: bban
        - `pan` string: pan
        - `maskedPan` string: maskedPan
        - `msisdn` string: msisdn
        - `currency` string: currency
      - `ultimateCreditor` string: ultimateCreditor
      - `debtorName` string: debtorName
      - `debtorAccount` AccountSchema: AccountSchema.
        - `iban` string: iban
        - `bban` string: bban
        - `pan` string: pan
        - `maskedPan` string: maskedPan
        - `msisdn` string: msisdn
        - `currency` string: currency
      - `ultimateDebtor` string: ultimateDebtor
      - `remittanceInformationUnstructured` string: remittanceInformationUnstructured
      - `remittanceInformationUnstructuredArray` string[]: remittanceInformationUnstructuredArray
      - `remittanceInformationStructured` string: remittanceInformationStructured
      - `remittanceInformationStructuredArray` string[]: remittanceInformationStructuredArray
      - `additionalInformation` string: additionalInformation
      - `purposeCode` string: purposeCode
      - `bankTransactionCode` string: bankTransactionCode
      - `proprietaryBankTransactionCode` string: proprietaryBankTransactionCode
      - `internalTransactionId` string: internalTransactionId
      - `balanceAfterTransaction` BalanceAfterTransactionSchema: BalanceAfterTransactionSchema.
        - `balanceAmount` TransactionAmountSchema, required: TransactionAmountSchema.
          - `amount` string, required: amount
          - `currency` string, required: currency
        - `balanceType` string, required: balanceType
    - `pending` TransactionSchema[]
      - `transactionId` string: transactionId
      - `entryReference` string: entryReference
      - `endToEndId` string: endToEndId
      - `mandateId` string: mandateId
      - `checkId` string: checkId
      - `creditorId` string: creditorId
      - `bookingDate` string: bookingDate
      - `valueDate` string: valueDate
      - `bookingDateTime` string: bookingDateTime
      - `valueDateTime` string: valueDateTime
      - `transactionAmount` TransactionAmountSchema, required: TransactionAmountSchema.
        - `amount` string, required: amount
        - `currency` string, required: currency
      - `currencyExchange` CurrencyExchangeSchema[]
        - `sourceCurrency` string: sourceCurrency
        - `exchangeRate` string: exchangeRate
        - `unitCurrency` string: unitCurrency
        - `targetCurrency` string: targetCurrency
        - `quotationDate` string: quotationDate
        - `contractIdentification` string: contractIdentification
      - `creditorName` string: creditorName
      - `creditorAccount` AccountSchema: AccountSchema.
        - `iban` string: iban
        - `bban` string: bban
        - `pan` string: pan
        - `maskedPan` string: maskedPan
        - `msisdn` string: msisdn
        - `currency` string: currency
      - `ultimateCreditor` string: ultimateCreditor
      - `debtorName` string: debtorName
      - `debtorAccount` AccountSchema: AccountSchema.
        - `iban` string: iban
        - `bban` string: bban
        - `pan` string: pan
        - `maskedPan` string: maskedPan
        - `msisdn` string: msisdn
        - `currency` string: currency
      - `ultimateDebtor` string: ultimateDebtor
      - `remittanceInformationUnstructured` string: remittanceInformationUnstructured
      - `remittanceInformationUnstructuredArray` string[]: remittanceInformationUnstructuredArray
      - `remittanceInformationStructured` string: remittanceInformationStructured
      - `remittanceInformationStructuredArray` string[]: remittanceInformationStructuredArray
      - `additionalInformation` string: additionalInformation
      - `purposeCode` string: purposeCode
      - `bankTransactionCode` string: bankTransactionCode
      - `proprietaryBankTransactionCode` string: proprietaryBankTransactionCode
      - `internalTransactionId` string: internalTransactionId
      - `balanceAfterTransaction` BalanceAfterTransactionSchema: BalanceAfterTransactionSchema.
        - `balanceAmount` TransactionAmountSchema, required: TransactionAmountSchema.
          - `amount` string, required: amount
          - `currency` string, required: currency
        - `balanceType` string, required: balanceType
  - `last_updated` string, date-time: The last time the account transactions were updated

## Other responses

- `400`: Incorrect date range in query parameters
- `401`: AccountInactiveError
- `403`: AccountResourceUnavailable
- `404`: Account not found
- `409`: Account state does not support this operation
- `429`: RateLimitError
- `500`: Couldn't update account transactions
- `503`: ConnectionError

---

[API](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api/revisions/01fd14b88051?raw)