---
title: "List account transactions"
method: GET
path: "/accounts/{id}/transactions"
tags: ["Transactions"]
---

# List account transactions

`GET /accounts/{id}/transactions`

## Request

- Base URL: `https://api.givechariot.com/fdx/v6`
- URL: `https://api.givechariot.com/fdx/v6/accounts/{id}/transactions`
- Auth: OAuth 2
  - Authorization code: `https://dashboard.givechariot.com/oauth/authorize`
  - Token URL: `https://api.givechariot.com/auth/oauth/token`

Get a paginated list of transactions for an account. When specifying a date range, both startTime and endTime must be provided together. Defaults to the last 7 days if no date range is specified. Data is available for up to 24 months from the current date.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `pageKey` string, uuid
- `startTime` string, date
- `endTime` string, date

## Response `200`

A paginated list of transactions

- ListTransactionsResponse: Paginated list of transactions.
  - `page` Page: Pagination metadata for list responses.
    - `nextPageKey` string: Cursor token to retrieve the next page of results. Absent when there are no more results.
    - `totalElements` integer: Total number of elements across all pages
  - `transactions` DepositTransaction[], required
    - `accountCategory` 'DEPOSIT_ACCOUNT', required: Category of account
    - `accountId` string, required: The account this transaction belongs to
    - `transactionId` string, required: Unique identifier for the transaction
    - `transactionTimestamp` string, date-time, required: Timestamp when the transaction occurred
    - `postedTimestamp` string, date-time: Timestamp when the transaction was posted
    - `description` string, required: Description of the transaction
    - `memo` string: Additional memo text
    - `debitCreditMemo` 'DEBIT' | 'CREDIT', required: Whether the transaction is a debit or credit
    - `category` string: Transaction category
    - `subCategory` string: Transaction sub-category
    - `status` 'PENDING' | 'POSTED' | 'AUTHORIZATION' | 'MEMO', required: Status of the transaction
    - `amount` number, double, required: Transaction amount
    - `lineItem` LineItem[]
      - `description` string
      - `amount` number, double
      - `checkNumber` integer
      - `memo` string
      - `reference` string
    - `reward` TransactionReward: Reward information associated with a transaction.
      - `categoryId` string
      - `accrued` number, double
      - `adjusted` number, double
    - `reference` string: Reference identifier for the transaction
    - `links` Link[]
      - `href` string, required: URI of the linked resource
    - `fiAttributes` FiAttribute[]
      - `name` string, required
      - `value` string, required
    - `transactionType` 'ADJUSTMENT' | 'ATMDEPOSIT' | 'ATMWITHDRAWAL' | 'BILLPAYMENT' | 'CHECK' | 'DEPOSIT' | 'DIRECTDEPOSIT' | 'DIVIDEND' | 'FEE' | 'INTEREST' | 'POSCREDIT' | 'POSDEBIT' | 'PREAUTHORIZEDDEPOSIT' | 'PREAUTHORIZEDWITHDRAWAL' | 'TRANSFER' | 'WITHDRAWAL': Type of deposit transaction
    - `payee` string: Payee name
    - `checkNumber` integer: Check number if applicable

## Other responses

- `400`: Invalid request parameters
- `401`: Missing or invalid OAuth 2.0 Bearer token
- `403`: Insufficient permissions or IP not whitelisted
- `404`: Resource not found
- `500`: Unexpected server error

---

[API](https://skmtc.dev/chariot-giving/apis/chariot-fdx-api.md) - [All operations](https://skmtc.dev/chariot-giving/apis/chariot-fdx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chariot-giving/apis/chariot-fdx-api/revisions/dbf5d377b683?raw)