# List Batch Transfers

List all batch transfers for the specified account in the request URL.

Endpoint: GET /v1/accounts/{account_id}/batch_transfers
Version: 1.0

## Path parameters:

  - `account_id` (string, required)
    The ID of the account to retrieve batch transfers for.

## Query parameters:

  - `page[number]` (string)
    The page number of the response.

  - `page[size]` (string)
    The size of each page in the response.

  - `filter[id]` (string)
    Filters the results to include only batch transfers with the given ID.

  - `filter[transfer_type]` (string)
    Filters the results to include only batch transfers with the given .
    Enum: "SCT", "SCT_INSTANT"

  - `filter[status]` (string)
    Filters the results to include only batch transfers with the given . Multiple comma-separated values are supported.
    Enum: "AUTHORIZATION_REQUIRED", "ACCEPTED", "REJECTED", "IN_PROGRESS", "FINISHED"

## Response 200 fields (application/json):

  - `id` (string)
    Unique ID of the batch transfer.
    Example: "f874b3102718a4d757a6b6e4d5996078sctb"

  - `account_id` (string)
    The account ID of the account that the batch transfer is associated with.
    Example: "236f9042a19b65c0867e10c922b93502cacc"

  - `status` (string)
    The status of the batch transfer.
    Enum: "AUTHORIZATION_REQUIRED", "ACCEPTED", "REJECTED", "IN_PROGRESS", "FINISHED"

  - `transfer_type` (string)
    The  for all transfers of the batch.
    Enum: "SCT", "SCT_INSTANT"

  - `reference` (string)
    A reference for the batch transfer.
    Example: "12f7ec0b-6762-4578-b49f-c0b1647d0e2d"

  - `description` (string)
    Optional description for the batch.
    Example: "Monthly Salary Payments"

  - `total_amount` (number)
    The total amount of all  transfers in the batch in cents.
    Example: 1000

  - `transfers_summary` (object)
    Summary of executed and failed transfer counts within the batch.

  - `transfers_summary.executed` (number)
    Number of transfers in the batch which were executed (successfully).
    Example: 9

  - `transfers_summary.failed` (number)
    Number of transfers in the batch which failed (not successful).
    Example: 1

  - `created_at` (string)
    UTC timestamp when the batch transfer was created.
    Example: "2025-04-01T13:59:52+00:00"

  - `started_at` (string)
    UTC timestamp when the batch transfer started the processing of all their transfers.
    Example: "2025-04-01T14:01:00+00:00"

  - `finished_at` (string)
    UTC timestamp when all transfers were processed and the status of the batch reached .
    Example: "2025-04-01T14:10:30+00:00"

  - `updated_at` (string)
    UTC timestamp when the batch transfer was updated the last time.
    Example: "2025-04-01T14:10:30+00:00"

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Solaris::Identification' for id 'bbbcccfff388923eb899a5852df6cidt'."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."