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

# List and search account transfers

> Returns a paginated, searchable list of transfers associated with the specified Main Dwolla account. Supports advanced filtering by amount range, date range, transfer status, and correlation ID. Results are limited to 10,000 transfers per query; use date range filters for historical data beyond this limit.



## OpenAPI

````yaml get /accounts/{id}/transfers
openapi: 3.1.0
info:
  title: Dwolla API
  description: Dwolla API Documentation
  contact:
    name: Dwolla Developer Relations Team
    url: https://developers.dwolla.com
    email: api@dwolla.com
  version: '2.0'
  termsOfService: https://www.dwolla.com/legal/tos/
  license:
    name: MIT
    url: https://github.com/Dwolla/dwolla-openapi/blob/master/LICENSE
servers:
  - url: https://api.dwolla.com
    description: Production server
  - url: https://api-sandbox.dwolla.com
    description: Sandbox server
security:
  - clientCredentials: []
tags:
  - name: tokens
    description: Operations related to Application Access Tokens
  - name: root
    description: Root API operations
  - name: accounts
    description: Operations related to Accounts
  - name: customers
    description: Operations related to Customers
  - name: kba
    description: Operations related to Knowledge-Based Authentication
  - name: beneficial owners
    description: Operations related to Beneficial Owners
  - name: documents
    description: Operations related to Documents
  - name: exchanges
    description: Operations related to Exchanges
  - name: exchange sessions
    description: Operations related to Exchange Sessions
  - name: funding sources
    description: Operations related to Funding Sources
  - name: transfers
    description: Operations related to Transfers
  - name: labels
    description: Operations related to Labels
  - name: mass payments
    description: Operations related to Mass Payments
  - name: events
    description: Operations related to Events
  - name: webhook subscriptions
    description: Operations related to Webhook Subscriptions
  - name: webhooks
    description: Operations related to Webhooks
  - name: client tokens
    description: Operations related to Client Tokens
  - name: sandbox simulations
    description: Sandbox-only operations for simulating processing of bank transfers
paths:
  /accounts/{id}/transfers:
    get:
      tags:
        - accounts
      summary: List and search account transfers
      description: >-
        Returns a paginated, searchable list of transfers associated with the
        specified Main Dwolla account. Supports advanced filtering by amount
        range, date range, transfer status, and correlation ID. Results are
        limited to 10,000 transfers per query; use date range filters for
        historical data beyond this limit.
      operationId: listAndSearchTransfers
      parameters:
        - name: id
          in: path
          description: Account's unique identifier
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/Accept'
        - name: search
          in: query
          description: >-
            A string to search on fields `firstName`, `lastName`, `email`,
            `businessName`, Customer ID, and Account ID
          required: false
          schema:
            type: string
        - name: startAmount
          in: query
          description: >-
            Only include transactions with an amount equal to or greater than
            `startAmount`
          required: false
          schema:
            type: string
        - name: endAmount
          in: query
          description: >-
            Only include transactions with an amount equal to or less than
            `endAmount`
          required: false
          schema:
            type: string
        - name: startDate
          in: query
          description: >-
            Only include transactions created after this date. ISO-8601 format
            `YYYY-MM-DD`
          required: false
          schema:
            type: string
        - name: endDate
          in: query
          description: >-
            Only include transactions created before this date. ISO-8601 format
            `YYYY-MM-DD`
          required: false
          schema:
            type: string
        - name: status
          in: query
          description: >-
            Filter on transaction status. Possible values are `pending`,
            `processed`, `failed`, or `cancelled`
          required: false
          schema:
            type: string
        - name: correlationId
          in: query
          description: >-
            A string value to search on if `correlationId` was specified for a
            transaction
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: Number of search results to return. Defaults to 25
          required: false
          schema:
            type: string
        - name: offset
          in: query
          description: Number of search results to skip. Use for pagination
          required: false
          schema:
            type: string
      responses:
        '200':
          description: successful operation
          headers: {}
          content:
            application/vnd.dwolla.v1.hal+json:
              schema:
                $ref: '#/components/schemas/Transfers'
        '404':
          description: not found
          headers: {}
          content:
            application/vnd.dwolla.v1.hal+json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: notFound
                  message:
                    type: string
                    example: Account not found.
      x-codeSamples:
        - lang: bash
          source: >
            GET
            https://api-sandbox.dwolla.com/accounts/CA366CA3-6D30-44D6-B0F3-8D86C64462A1/transfers

            Accept: application/vnd.dwolla.v1.hal+json

            Authorization: Bearer
            pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY
        - lang: javascript
          source: |
            // Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
            dwolla
              .get("accounts/CA366CA3-6D30-44D6-B0F3-8D86C64462A1/transfers")
              .then((res) => res.body.total); // => 1
        - lang: python
          source: >
            # Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python

            transfers =
            app_token.get('accounts/CA366CA3-6D30-44D6-B0F3-8D86C64462A1/transfers')

            transfers.body['total'] # => 1
        - lang: php
          source: >
            <?php

            // Using dwollaswagger -
            https://github.com/Dwolla/dwolla-swagger-php

            $transfersApi = new DwollaSwagger\TransfersApi($apiClient);


            $transfers =
            $transfersApi->getAccountTransfers("CA366CA3-6D30-44D6-B0F3-8D86C64462A1");

            $transfers->total; # => 1

            ?>
        - lang: ruby
          source: >
            # Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby

            transfers = app_token.get
            "accounts/CA366CA3-6D30-44D6-B0F3-8D86C64462A1/transfers"

            transfers.total # => 1
components:
  parameters:
    Accept:
      name: Accept
      in: header
      required: true
      description: >-
        The media type of the response. Must be
        application/vnd.dwolla.v1.hal+json
      schema:
        type: string
        enum:
          - application/vnd.dwolla.v1.hal+json
        default: application/vnd.dwolla.v1.hal+json
  schemas:
    Transfers:
      title: Transfers
      type: object
      properties:
        _links:
          additionalProperties:
            $ref: '#/components/schemas/HalLink'
        _embedded:
          type: object
          properties:
            transfers:
              type: array
              items:
                $ref: '#/components/schemas/Transfer'
        total:
          type: integer
          example: 100
    HalLink:
      title: HalLink
      type: object
      properties:
        href:
          type: string
          example: https://api.dwolla.com
        type:
          type: string
          example: application/vnd.dwolla.v1.hal+json
        resource-type:
          type: string
          example: resource-type
    Transfer:
      title: Transfer
      type: object
      properties:
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HalLink'
        id:
          type: string
          example: 15c6bcce-46f7-e811-8112-e8dd3bececa8
        status:
          type: string
          example: pending
        amount:
          type: object
          properties:
            value:
              type: string
              example: '42.00'
            currency:
              type: string
              example: USD
        created:
          type: string
          format: date-time
          example: '2018-12-03T22:00:22.970Z'
        clearing:
          type: object
          properties:
            source:
              type: string
              example: standard
            destination:
              type: string
              example: same-day
        metadata:
          type: object
          properties:
            paymentId:
              type: string
              example: '12345678'
            note:
              type: string
              example: Payment for completed work Dec. 1
        achDetails:
          type: object
          description: >-
            ACH-specific details for the transfer. Present when transfer was
            processed via ACH network.
          properties:
            source:
              type: object
              description: >-
                Information sent to the source/originating bank account along
                with the transfer
              properties:
                addenda:
                  type: object
                  description: Contains addenda information for the transfer
                  properties:
                    values:
                      type: array
                      items:
                        type: string
                        example: ABC123_AddendaValue
                      description: An array containing a single string addenda value
                beneficiaryName:
                  type: string
                  description: >-
                    Beneficiary of the transaction's name. In general, should
                    match the user onboarded to the Platform's name
                  example: John Doe
                companyEntryDescription:
                  type: string
                  description: Describes the purpose of the transaction
                  example: PAYMENT
                  enum:
                    - REVERSAL
                    - RECLAIM
                    - NO CHECK
                    - AUTOENROLL
                    - REDEPCHECK
                    - RETURN FEE
                    - RETRY PMNT
                    - HEALTHCARE
                    - PAYMENT
                companyId:
                  type: string
                  description: Numeric identifier of originator
                  example: '1234567890'
                companyName:
                  type: string
                  description: Name of the originator
                  example: Acme Corporation
                effectiveDate:
                  type: string
                  format: date
                  description: >-
                    The date when the ACH transaction becomes effective,
                    formatted as YYYY-MM-DD. This is typically the settlement
                    date for the transaction
                  example: '2021-12-01'
                postingData:
                  type: string
                  description: >-
                    Suggested memo line format for bank statements, structured
                    as companyName:companyDiscretionaryData:beneficiaryName
                  example: Acme Corporation:Payment Reference:John Doe
                routingNumber:
                  type: string
                  description: >-
                    Routing number of Originating Depository Financial
                    Institution (ODFI). Identifies the financial institution
                    that originated the ACH transaction
                  example: '222222226'
                traceId:
                  type: string
                  description: >-
                    A unique identifier for tracing the ACH transaction through
                    the banking network. Used for transaction tracking and
                    reconciliation purposes
                  example: '222222225926346'
            destination:
              type: object
              description: >-
                Information sent to the destination/receiving bank account along
                with the transfer
              properties:
                addenda:
                  type: object
                  description: Contains addenda information for the transfer
                  properties:
                    values:
                      type: array
                      items:
                        type: string
                        example: ZYX987_AddendaValue
                      description: An array containing a single string addenda value
                beneficiaryName:
                  type: string
                  description: >-
                    Beneficiary of the transaction's name. In general, should
                    match the user onboarded to the Platform's name
                  example: Jane Smith
                companyEntryDescription:
                  type: string
                  description: Describes the purpose of the transaction
                  example: PAYMENT
                  enum:
                    - REVERSAL
                    - RECLAIM
                    - NO CHECK
                    - AUTOENROLL
                    - REDEPCHECK
                    - RETURN FEE
                    - RETRY PMNT
                    - HEALTHCARE
                    - PAYMENT
                companyId:
                  type: string
                  description: Numeric identifier of originator
                  example: '1234567890'
                companyName:
                  type: string
                  description: Name of the originator
                  example: Acme Corporation
                effectiveDate:
                  type: string
                  format: date
                  description: >-
                    The date when the ACH transaction becomes effective,
                    formatted as YYYY-MM-DD. This is typically the settlement
                    date for the transaction
                  example: '2021-12-01'
                postingData:
                  type: string
                  description: >-
                    Suggested memo line format for bank statements, structured
                    as companyName:companyDiscretionaryData:beneficiaryName
                  example: Acme Corporation:Payment Reference:Jane Smith
                routingNumber:
                  type: string
                  description: >-
                    Routing number of Originating Depository Financial
                    Institution (ODFI). Identifies the financial institution
                    that originated the ACH transaction
                  example: '222222226'
                traceId:
                  type: string
                  description: >-
                    A unique identifier for tracing the ACH transaction through
                    the banking network. Used for transaction tracking and
                    reconciliation purposes
                  example: '222222225926346'
        rtpDetails:
          type: object
          description: >-
            Real-Time Payments (RTP) network specific details. Present when
            transfer was processed via RTP network.
          properties:
            destination:
              type: object
              description: RTP destination details with network identifiers
              properties:
                remittanceData:
                  type: string
                  description: Remittance information included in the transfer request
                  example: ABC_123 Remittance Data
                networkId:
                  type: string
                  description: Unique identifier for the transfer within the RTP network
                  example: 20210617021214273T1BG27487110796028
                endToEndReferenceId:
                  type: string
                  description: End-to-end reference identifier for the RTP transfer
                  example: E2E-RTP-20210617-001
        fedNowDetails:
          type: object
          description: >-
            FedNow Service network specific details. Present when transfer was
            processed via FedNow network.
          properties:
            destination:
              type: object
              description: FedNow destination details with network identifiers
              properties:
                remittanceData:
                  type: string
                  description: Remittance information included in the transfer request
                  example: ABC_123 Remittance Data
                networkId:
                  type: string
                  description: Unique identifier for the transfer within the FedNow network
                  example: 20240115123456789FEDNOW123456
                endToEndReferenceId:
                  type: string
                  description: End-to-end reference identifier for the FedNow transfer
                  example: E2E-FEDNOW-20240115-001
        correlationId:
          type: string
          example: 8a2cdc8d-629d-4a24-98ac-40b735229fe2
        processingChannel:
          type: object
          properties:
            destination:
              type: string
              enum:
                - real-time-payments
                - fed-now
              description: The payment network used to process the transfer
              example: real-time-payments
  securitySchemes:
    clientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /token
          x-speakeasy-token-endpoint-authentication: client_secret_basic
          scopes: {}

````