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

# List BankTransfer records (v1)

> Retrieve a paginated list of BankTransfer records with filtering and ordering options.



## OpenAPI

````yaml /developers/openapi/resources-v1.json get /public/v1/bank-transfers/
openapi: 3.1.0
info:
  title: DualEntry Public API
  version: 1.0.0
  description: ''
servers:
  - url: https://api.dualentry.com
    description: Production environment
  - url: https://api-dev.dualentry.com
    description: Development environment (for testing)
security: []
tags:
  - name: Health
    description: >-
      Monitor API availability and service status. Use these endpoints to verify
      connectivity and check if the API is operational.
  - name: Webhooks
    description: >-
      Register webhook endpoints to receive real-time event notifications when
      records change in your organization. Manage subscriptions, view available
      topics, and inspect delivery history.
  - name: Accounts
    description: >-
      Manage your chart of accounts. Create and maintain the accounts used to
      categorize financial transactions, including assets, liabilities, equity,
      revenue, and expenses.
  - name: Budgets
    description: >-
      Manage financial budgets. Create and track income statement and balance
      sheet budgets with monthly cell values, actuals comparison, and
      classification filtering.
  - name: Companies
    description: >-
      Access and manage company information. Retrieve details about your
      organization including legal name, tax identifiers, addresses, and
      accounting preferences.
  - name: Customers
    description: >-
      Manage customer records. Create, update, and track customers who purchase
      goods or services from your organization, including contact information,
      billing addresses, and payment terms.
  - name: Contracts
    description: >-
      Manage revenue recognition contracts. Create and retrieve contracts with
      performance obligations, and manage obligation usage for usage-based
      obligations.
  - name: Items
    description: >-
      Manage products and services. Define items that appear on invoices and
      bills, including pricing, descriptions, and associated accounts for
      revenue or expense tracking.
  - name: Vendors
    description: >-
      Manage vendor and supplier records. Track businesses and individuals from
      whom you purchase goods or services, including contact details, payment
      terms, and tax information.
  - name: Journal Entries
    description: >-
      Create and manage manual journal entries. Record direct debits and credits
      to accounts for adjustments, accruals, reclassifications, and other
      accounting transactions.
  - name: Invoices
    description: >-
      Manage sales invoices. Create and track invoices sent to customers for
      goods or services rendered, including line items, taxes, discounts, and
      payment status.
  - name: Sales Orders
    description: >-
      Create and manage sales orders. Track customer orders for goods or
      services before invoicing, including line items, quantities, fulfillment
      status, and invoicing progress.
  - name: Bills
    description: >-
      Manage vendor bills and payables. Record and track bills received from
      vendors for goods or services purchased, including line items, due dates,
      and payment tracking.
  - name: Customer Prepayments
    description: >-
      Track advance payments from customers. Access prepayments received before
      goods or services are delivered, which can be applied to future invoices.
  - name: Customer Prepayment Applications
    description: >-
      Apply customer prepayments and credits to invoices. Record applications of
      prepayments or credit memos to reduce invoice balances.
  - name: Customer Deposits
    description: >-
      Manage customer deposit transactions. Record and track deposits received
      from customers as security or partial payment, held in liability accounts
      until earned or refunded.
  - name: Customer Refunds
    description: >-
      Process and track customer refunds. Record refunds issued to customers for
      overpayments, returns, or cancelled transactions.
  - name: Customer Credits
    description: >-
      Manage credit memos for customers. Issue credits for returned goods,
      billing adjustments, or discounts that reduce customer balances or can be
      applied to future invoices.
  - name: Cash Sales
    description: >-
      Record immediate cash sales transactions. Track sales where payment is
      received at the time of sale, including point-of-sale transactions and
      cash receipts.
  - name: Customer Payments
    description: >-
      Record and manage customer payments. Track payments received from
      customers and apply them to outstanding invoices, including partial
      payments and overpayments.
  - name: Recurring Invoices
    description: >-
      Automate recurring billing. Set up and manage templates for invoices that
      are automatically generated on a regular schedule (e.g., monthly
      subscriptions).
  - name: Recurring Bills
    description: >-
      Automate recurring expenses. Configure templates for bills that repeat on
      a regular basis (e.g., monthly rent, subscriptions) to streamline expense
      tracking.
  - name: Recurring Journal Entries
    description: >-
      Automate recurring journal entries. Create templates for journal entries
      that occur regularly (e.g., monthly depreciation, amortization) to ensure
      consistent accounting treatment.
  - name: Classifications
    description: >-
      Manage custom classification dimensions. Create and maintain
      classification categories (e.g., departments, locations, projects) used to
      tag and analyze transactions across multiple dimensions.
  - name: Classifications Lines
    description: >-
      Manage classification values. Define the specific values within each
      classification category that can be assigned to transaction line items for
      detailed reporting and analysis.
  - name: Custom Fields
    description: >-
      Manage custom field definitions. Extend records with organization-specific
      attributes — name, type (text, number, boolean, date, single_select,
      multi_select, currency, link, paragraph), default value, options, and
      which record types (invoice, bill, customer, vendor, etc.) and companies
      the field applies to. Values are set via the `custom_fields` attribute on
      each record's create/update endpoint.
  - name: Purchase Orders
    description: >-
      Create and track purchase orders. Manage formal requests to vendors for
      goods or services, including approval workflows, receiving tracking, and
      bill matching.
  - name: Vendor Payments
    description: >-
      Record and manage vendor payments. Track payments made to vendors and
      apply them to outstanding bills and credits, including partial payments
      and overpayments.
  - name: Vendor Prepayments
    description: >-
      Track advance payments to vendors. Record prepayments made before goods or
      services are received, which can be applied to future bills.
  - name: Vendor Prepayment Applications
    description: >-
      Apply vendor prepayments to bills. Record applications of prepayments to
      reduce bill balances and track amounts owed.
  - name: Vendor Credits
    description: >-
      Manage vendor credit memos. Record credits from vendors for returned
      goods, billing adjustments, or discounts that reduce amounts owed or can
      be applied to future bills.
  - name: Vendor Refunds
    description: >-
      Process and track vendor refunds. Record refunds received from vendors for
      overpayments, returns, or cancelled transactions.
  - name: Paper Checks
    description: >-
      Manage paper check printing. Create, queue, and batch print paper checks
      for vendor payments, direct expenses, vendor prepayments, and customer
      refunds.
  - name: Direct Expenses
    description: >-
      Record direct expense transactions. Track payments made directly from a
      bank or credit card account for expenses, without going through the
      accounts payable process.
  - name: Bank Transfers
    description: >-
      Manage bank-to-bank transfers. Record and track transfers between bank and
      credit card accounts, including multi-currency transfers with exchange
      rate handling.
  - name: Bank Match
    description: >-
      Reconcile bank-feed rows against accounting transactions. List bank rows,
      trigger the matching pipeline, read AI suggestions, and confirm or undo
      matches. V2 API only.
  - name: Fixed Assets
    description: >-
      Manage fixed assets and capital equipment. Create, update, and track
      long-lived tangible assets including depreciation schedules, account
      assignments, and asset lifecycle management.
  - name: Intercompany Journal Entries
    description: >-
      Create and manage intercompany journal entries. Record GL activity that
      spans two or more companies within the same organization, with per-line
      company assignment and automatic intercompany elimination.
  - name: Depreciation Books
    description: >-
      Discover available depreciation books for multi-book depreciation. Each
      organization has a posting book (BOOK) and may have additional tax books
      (FEDERAL, AMT, STATE_*). V2 API only.
  - name: VAT Rates
    description: >-
      Look up available VAT (Value Added Tax) rates for your organization. Use
      these IDs as `vat_rate_id` on transaction line items. Rates are scoped by
      country and include standard, reduced, zero-rated, exempt, and reverse
      charge types. V2 API only.
  - name: GST Tax Rates
    description: >-
      Look up available GST (Goods and Services Tax) rates for your
      organization. Use these IDs as `gst_tax_rate_id` on transaction line
      items. Covers AU, NZ, SG, IN, CA GST regimes and MY SST, with
      per-component breakdowns (e.g. CGST+SGST for India). V2 API only.
  - name: Product Tax Codes
    description: >-
      Manage organization product tax codes and discover global product tax
      codes. Use these IDs as `product_tax_code_id` on item payloads. V2 API
      only.
  - name: Approval Policies
    description: >-
      Manage approval workflows and policies. Define approval rules, steps,
      conditions, and approvers for different record types. Monitor workflow
      execution states and view approval history.
  - name: Inbox
    description: >-
      View pending approvals and approval status. Access transactions and
      records awaiting approval across the organization, including full approval
      workflow details, approvers, and action history.
paths:
  /public/v1/bank-transfers/:
    get:
      tags:
        - Bank Transfers
      summary: List BankTransfer records
      description: >-
        Retrieve a paginated list of BankTransfer records with filtering and
        ordering options.
      operationId: list_BankTransfer_records
      parameters:
        - in: query
          name: search
          schema:
            title: Search
            type:
              - string
              - 'null'
          required: false
        - in: query
          name: company_id
          schema:
            q: company_id__in
            title: Company Id
            items:
              type: integer
            type:
              - array
              - 'null'
          required: false
        - in: query
          name: number
          schema:
            q: number__in
            title: Number
            items:
              type: integer
            type:
              - array
              - 'null'
          required: false
        - in: query
          name: start_date
          schema:
            q: transaction__date__gte
            title: Start Date
            format: date
            type:
              - string
              - 'null'
          required: false
        - in: query
          name: end_date
          schema:
            q: transaction__date__lte
            title: End Date
            format: date
            type:
              - string
              - 'null'
          required: false
        - in: query
          name: debit_bank_account_number
          schema:
            title: Debit Bank Account Number
            items:
              type: integer
            type:
              - array
              - 'null'
          required: false
        - in: query
          name: credit_bank_account_number
          schema:
            title: Credit Bank Account Number
            items:
              type: integer
            type:
              - array
              - 'null'
          required: false
        - in: query
          name: record_status
          schema:
            q: transaction__record_status__in
            title: Record Status
            items:
              $ref: '#/components/schemas/RecordStatus'
            type:
              - array
              - 'null'
          required: false
        - in: query
          name: approval_status
          schema:
            title: Approval Status
            items:
              type: string
            type:
              - array
              - 'null'
          required: false
        - in: query
          name: updated_after
          schema:
            q: updated_at__gte
            title: Updated After
            format: date-time
            type:
              - string
              - 'null'
          required: false
        - in: query
          name: updated_before
          schema:
            q: updated_at__lte
            title: Updated Before
            format: date-time
            type:
              - string
              - 'null'
          required: false
        - in: query
          name: ordering
          schema:
            default: id
            title: Ordering
            type:
              - string
              - 'null'
          required: false
        - in: query
          name: limit
          schema:
            default: 100
            description: Number of records to return per page (capped at 100)
            minimum: 1
            title: Limit
            type: integer
          required: false
          description: Number of records to return per page (capped at 100)
        - in: query
          name: offset
          schema:
            default: 0
            description: Number of records to skip before starting to return results
            minimum: 0
            title: Offset
            type: integer
          required: false
          description: Number of records to skip before starting to return results
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedPublicBankTransferSchemaOut'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchema'
components:
  schemas:
    RecordStatus:
      enum:
        - draft
        - posted
        - archived
      title: RecordStatus
      type: string
    PagedPublicBankTransferSchemaOut:
      properties:
        items:
          items:
            $ref: '#/components/schemas/PublicBankTransferSchemaOut'
          title: Items
          type: array
        count:
          title: Count
          type: integer
      required:
        - items
        - count
      title: PagedPublicBankTransferSchemaOut
      type: object
    ErrorSchema:
      properties:
        success:
          const: false
          default: false
          title: Success
          type: boolean
        errors:
          additionalProperties:
            items:
              type: string
            type: array
          title: Errors
          type: object
      required:
        - errors
      title: ErrorSchema
      type: object
    PublicBankTransferSchemaOut:
      properties:
        bank_match_status:
          title: Bank Match Status
          type:
            - string
            - 'null'
        reconciliation_status:
          title: Reconciliation Status
          type:
            - string
            - 'null'
        created_by:
          anyOf:
            - $ref: '#/components/schemas/AuditActorSchemaOut'
            - type: 'null'
        updated_by:
          anyOf:
            - $ref: '#/components/schemas/AuditActorSchemaOut'
            - type: 'null'
        internal_id:
          title: Internal Id
          type: integer
        number:
          title: Number
          type: integer
        transaction_id:
          title: Transaction Id
          type: integer
        debit_entry_id:
          title: Debit Entry Id
          type: integer
        credit_entry_id:
          title: Credit Entry Id
          type: integer
        date:
          description: >-
            Posting date (GL date) - the date when the transaction is recorded
            in the general ledger
          format: date
          title: Date
          type: string
        transaction_date:
          description: >-
            Transaction date (inception date) - the date when the transaction
            actually occurred
          format: date
          title: Transaction Date
          type: string
        company_id:
          title: Company Id
          type: integer
        company_name:
          title: Company Name
          type: string
        company_currency:
          title: Company Currency
          type: string
        debit_bank_account_number:
          title: Debit Bank Account Number
          type:
            - integer
            - 'null'
        credit_bank_account_number:
          title: Credit Bank Account Number
          type:
            - integer
            - 'null'
        amount:
          description: Transfer amount
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$
          title: Amount
          type: string
        exchange_rate:
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,16}0*$
          title: Exchange Rate
          type: string
        memo:
          title: Memo
          type: string
        record_status:
          $ref: '#/components/schemas/RecordStatus'
        currency_iso_4217_code:
          default: []
          items:
            type: string
          title: Currency Iso 4217 Code
          type: array
        created_at:
          description: Date and time the record was created
          format: date-time
          title: Created At
          type: string
        updated_at:
          description: Date and time the record was last updated
          format: date-time
          title: Updated At
          type: string
      required:
        - internal_id
        - number
        - transaction_id
        - debit_entry_id
        - credit_entry_id
        - date
        - transaction_date
        - company_id
        - company_name
        - company_currency
        - debit_bank_account_number
        - credit_bank_account_number
        - amount
        - exchange_rate
        - memo
        - record_status
        - created_at
        - updated_at
      title: PublicBankTransferSchemaOut
      type: object
    AuditActorSchemaOut:
      description: Schema for audit actor information.
      properties:
        actor_type:
          title: Actor Type
          type:
            - string
            - 'null'
        email:
          title: Email
          type:
            - string
            - 'null'
        first_name:
          title: First Name
          type:
            - string
            - 'null'
        last_name:
          title: Last Name
          type:
            - string
            - 'null'
        timestamp:
          title: Timestamp
          format: date-time
          type:
            - string
            - 'null'
      title: AuditActorSchemaOut
      type: object

````