> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ledgersyncappv2.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List accounts transactions for the given client

> Reads the transactions LedgerSync has stored, newest first, and never contacts the bank, so a broken connection still returns what was collected before it broke. Send source (the bank's source from the account list) and accountId for each account. Parameters not listed here, such as id, are ignored.



## OpenAPI

````yaml /openapi-v2.json get /api/v2/transactions/list
openapi: 3.1.0
info:
  title: LedgerSync V2 API
  version: '2.0'
servers:
  - url: https://ledgersyncappv2.com
    description: Production
  - url: https://staging.ledgersyncappv2.com
    description: Sandbox
security: []
tags:
  - name: account-api
    description: Account REST APIs
  - name: password-api
    description: Password REST APIs
  - name: transaction-api
    description: Transaction REST APIs
  - name: phone-verification-api
    description: Phone Verification REST APIs
  - name: employee-api
    description: Employee REST APIs
  - name: client-api
    description: Client REST APIs
  - name: check-api
    description: Check REST APIs
  - name: accounting-ai-api
    description: AI rule suggestion endpoints for external accounting integrations
  - name: institution-api
    description: Institution REST APIs
  - name: statement-api
    description: Statement REST APIs
  - name: authentication-api
    description: Auth REST APIs
paths:
  /api/v2/transactions/list:
    get:
      tags:
        - transaction-api
      summary: List accounts transactions for the given client
      description: >-
        Reads the transactions LedgerSync has stored, newest first, and never
        contacts the bank, so a broken connection still returns what was
        collected before it broke. Send source (the bank's source from the
        account list) and accountId for each account. Parameters not listed
        here, such as id, are ignored.
      operationId: getAccountsTransactions
      parameters:
        - name: username
          in: query
          description: The client's username, as returned by the client list.
          required: true
          schema:
            type: string
            description: The client's username, as returned by the client list.
        - name: bankAccountId
          in: query
          description: >-
            Limits the response to one connection: banks[].id from the account
            list. Prefer accountId.
          required: false
          schema:
            type: integer
            format: int64
            description: >-
              Limits the response to one connection: banks[].id from the account
              list. Prefer accountId.
        - name: accountId
          in: query
          description: >-
            The account's id from the account list (banks[].accounts[].id).
            Without accountId or bankAccountId, the response holds every visible
            account of the client for that source.
          required: false
          schema:
            type: integer
            format: int64
            description: >-
              The account's id from the account list (banks[].accounts[].id).
              Without accountId or bankAccountId, the response holds every
              visible account of the client for that source.
        - name: from
          in: query
          description: >-
            First day to include, yyyy-MM-dd (MM/dd/yyyy is also accepted).
            FINICITY filters on the posted date, MX on the transaction date; FDE
            ignores the date range.
          required: false
          schema:
            type: string
            description: >-
              First day to include, yyyy-MM-dd (MM/dd/yyyy is also accepted).
              FINICITY filters on the posted date, MX on the transaction date;
              FDE ignores the date range.
            example: '2026-07-01'
          example: '2026-07-01'
        - name: to
          in: query
          description: >-
            Last day to include, yyyy-MM-dd; the whole day is included. FDE
            ignores it.
          required: false
          schema:
            type: string
            description: >-
              Last day to include, yyyy-MM-dd; the whole day is included. FDE
              ignores it.
            example: '2026-09-29'
          example: '2026-09-29'
        - name: description
          in: query
          description: >-
            Returns only transactions whose description contains this text,
            ignoring case. For MX the bank's original description is matched
            too. FDE ignores it.
          required: false
          schema:
            type: string
            description: >-
              Returns only transactions whose description contains this text,
              ignoring case. For MX the bank's original description is matched
              too. FDE ignores it.
        - name: page
          in: query
          description: Page number, starting at 0.
          required: false
          schema:
            type: integer
            format: int32
            default: 0
            description: Page number, starting at 0.
            maximum: 2147483647
            minimum: 0
        - name: rowsPerPage
          in: query
          description: >-
            10, 20 or 50. FINICITY and MX return 50 rows per page for any other
            value; FDE needs one of the three.
          required: false
          schema:
            type: integer
            format: int32
            default: 50
            description: >-
              10, 20 or 50. FINICITY and MX return 50 rows per page for any
              other value; FDE needs one of the three.
            enum:
              - 10
              - 20
              - 50
        - name: addOn
          in: query
          description: 'Legacy: true reads FDE when source is not sent. Use source instead.'
          required: false
          deprecated: true
          schema:
            type: boolean
            default: false
            deprecated: true
            description: >-
              Legacy: true reads FDE when source is not sent. Use source
              instead.
        - name: source
          in: query
          description: >-
            Bank-data provider of the account: the bank's source from the
            account list, in uppercase. Defaults to FINICITY, so an MX account
            returns no transactions unless source=MX is sent. Takes precedence
            over addOn.
          required: false
          schema:
            type: string
            default: FINICITY
            description: >-
              Bank-data provider of the account: the bank's source from the
              account list, in uppercase. Defaults to FINICITY, so an MX account
              returns no transactions unless source=MX is sent. Takes precedence
              over addOn.
            enum:
              - FINICITY
              - MX
              - FDE
        - name: Auth-Token
          in: header
          description: Authentication token provided during the authentication process
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Accounts Transactions data
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/TransactionsResponse'
        '403':
          description: You are not allowed to retrieve data
          content:
            '*/*':
              schema:
                type: string
components:
  schemas:
    TransactionsResponse:
      type: object
      properties:
        totalItems:
          type: integer
          format: int64
          description: Number of matching transactions across all pages.
        selectedPage:
          type: integer
          format: int32
          description: >-
            The page returned, starting at 0. A page past the end returns an
            empty list.
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/TransactionResponse'
    TransactionResponse:
      type: object
      properties:
        id:
          type: integer
          format: int64
          description: >-
            LedgerSync transaction id. Ids are numbered separately per source,
            so store the id together with the source, or use transactionId.
        transactionId:
          type: string
          description: >-
            The source and the id together, for example FINICITY_119874 or
            MX_628988. Unique across sources.
          example: FINICITY_119874
        transactionHash:
          type: string
          description: >-
            FINICITY only; null for MX. A 32-character hash of the transaction's
            details that stays the same when a connection is disconnected and
            reconnected. Use it to match transactions across a reconnect; two
            identical purchases on the same day share it.
        postedDate:
          type: string
          description: >-
            The day the bank posted the transaction. The format depends on the
            source: FINICITY and FDE send yyyy-MM-ddTHH:mm:ss in UTC with no
            offset (read the first 10 characters as the date), MX sends
            MM/dd/yyyy. Null on FINICITY pending transactions. On MX pending
            transactions it holds the transaction date.
          example: '2023-04-01T12:00:00'
        bankName:
          type: string
        bankAccount:
          type: string
        bankAccountId:
          type: string
          description: >-
            FINICITY: the provider's account id. MX: the LedgerSync connection
            id (banks[].id in the account list). FDE: the account code.
        accountNumber:
          type: string
        accountId:
          type: integer
          format: int64
          description: >-
            The LedgerSync account id, the same id as in the account list
            (banks[].accounts[].id).
        status:
          type: string
          description: >-
            FINICITY: active, pending or shadow. MX: POSTED or PENDING. FDE: as
            FDE reports it.
        transactionDate:
          type: string
          description: >-
            The day the transaction happened as the bank reports it (for a card,
            the purchase date). Same format rules as postedDate. LedgerSync
            passes the bank's value through unchanged.
          example: '2023-04-01T12:00:00'
        description:
          type: string
        type:
          type: string
          description: As the institution reports it. MX sends DEBIT or CREDIT.
        amount:
          type: number
          format: double
          description: 'Signed amount: negative means money out of the account.'
        normalizePayeeName:
          type: string
        categorization:
          type: string
        payee:
          type: string
        memo:
          type: string
        currencySymbol:
          type: string
        checkNum:
          type: string
        runningBalance:
          type: number
          format: double

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.