---
title: "Bulk Transfer"
method: POST
path: "/pms/api/external/request/wallet/bulk-transfer/"
tags: ["Transfers"]
---

# Bulk Transfer

`POST /pms/api/external/request/wallet/bulk-transfer/`

Initiate multiple wallet transfers in a single batch

## Headers

- `api-key` string, required
- `api-secret` string, required
- `Content-Type` 'application/json', required

## Request body

- BulkTransferRequest
  - `batch_reference` string, required — Unique reference for the bulk batch
  - `transfers` object[], required
    - `amount` string, required — Amount for this transfer
    - `account_number` string, required — Destination account number
    - `bank_code` string, required — Destination bank code
    - `account_name` string — Optional account name
    - `narration` string — Transfer description
    - `reference` string, required — Unique reference for this transfer

## Response `200`

Bulk transfer initiated successfully

- BulkTransferResponse
  - `status` boolean — Request status
  - `message` string — Response message
  - `data` object — Bulk transfer result data

---

[API](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api.md) · [All operations](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payvessel/payvessel-value-added-services-api/revisions/31040a9358ef/schema)