---
title: "List Batch Transactions"
method: GET
path: "/batch_transactions"
tags: ["Batch Transactions"]
---

# List Batch Transactions

`GET /batch_transactions`

Retrieve an ordered and paginated list of existing **Batch Transactions**. The list can be filtered by **Account**, **Batch ID**, **Item**, and **Transaction Type**.

## Query parameters

- `limit` integer
- `offset` integer
- `account_id` string
- `batch_id` string
- `item_id` string
- `transaction_type` 'payment' | 'refund' | 'disbursement' | 'fee' | 'deposit' | 'withdrawal'
- `transaction_type_method` 'credit_card' | 'npp' | 'bpay' | 'wallet_account_transfer' | 'wire_transfer' | 'misc'
- `direction` 'debit' | 'credit'
- `created_before` string
- `created_after` string
- `disbursement_bank` string
- `processing_bank` string

## Response `200`

OK

- ListBatchTransactions
  - `batch_transactions` BatchTransaction[]
    - `id` string, required
    - `reference_id` string
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `status` string
    - `uuid` string
    - `disbursement_bank` string
    - `processing_bank` string
    - `external_reference` string
    - `reference_amount` string
    - `internal_state` string
    - `internal_status` string
    - `account_external` object
      - `account_type_id` string
      - `currency` object
        - `code` string
    - `external_account_details` string
    - `external_account_details_encrypted` boolean
    - `marketplace` object
      - `group_name` string
      - `name` string
      - `short_name` string
      - `uuid` string, uuid
      - `account_details` string
      - `account_details_encrypted` boolean
    - `first_name` string
    - `last_name` string
    - `user_email` string
    - `user_external_id` string
    - `legal_entity_id` string
    - `phone` string
    - `payout_currency` string
    - `type` string
    - `type_method` string
    - `batch_id` integer
    - `cuscal_payment_transaction_id` string
    - `reference` string
    - `state` string
    - `user_id` string
    - `account_id` string
    - `account_type` string
    - `from_user_name` string
    - `from_user_id` string
    - `refund_state` string
    - `amount` integer, required
    - `currency` string
    - `company` string
    - `address_line1` string
    - `address_line2` string
    - `address_city` string
    - `address_state` string
    - `address_postcode` string
    - `address_country` object
      - `id` string
      - `name` string
      - `three_code` string
      - `two_code` string
      - `currency_id` string
      - `numeric_code` string
    - `country` string
    - `debit_credit` string
    - `description` string
    - `item` object
      - `id` string
      - `item_number` string
    - `deposit_reference` string
    - `related` object
      - `account_to` object
        - `id` string
        - `account_type` string
        - `user_id` string
    - `links` object
      - `self` string
      - `users` string
      - `fees` string
      - `wallet_accounts` string
      - `card_accounts` string
      - `paypal_accounts` string
      - `bank_accounts` string
      - `items` string
      - `marketplace` string
  - `meta` object
    - `limit` integer
    - `offset` integer
    - `total` integer
  - `links` object
    - `self` string

---

[API](https://skmtc.net/hellozai/apis/assembly-api.md) · [All operations](https://skmtc.net/hellozai/apis/assembly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellozai/assembly-api/versions/60b528b2e015/schema)