---
title: "Changes to Initiate bulk VA transfer"
method: POST
path: "/v1/va/transfer/bulk"
---

# Changes to Initiate bulk VA transfer

`POST /v1/va/transfer/bulk`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `4aed77604588`: 16 breaking, 26 warning, 52 info

## Changes

- **2026-11-03** `4aed77604588`: 16 breaking, 26 warning, 52 info
  - added the new required request property `amount`
  - added the new required request property `currency`
  - added the new required request property `narration`
  - the request's body type changed from no type to `object`
  - the `header` request parameter `idempotency-key` became required
  - the `allOf[subschema #2]/` response's property type changed from `object` to no type for status `201`
  - the `allOf[subschema #2]/data/beneficiary/id` response's property format changed from `uuid` to no format for status `201`
  - the `allOf[subschema #2]/data/failedCount` response's property type changed from `integer` to `number` for status `201`
  - the `allOf[subschema #2]/data/id` response's property format changed from `uuid` to no format for status `201`
  - the `allOf[subschema #2]/data/items/items/id` response's property format changed from `uuid` to no format for status `201`
  - the `allOf[subschema #2]/data/items/items/sequence` response's property type changed from `integer` to `number` for status `201`
  - the `allOf[subschema #2]/data/items/items/transactionId` response's property format changed from `uuid` to no format for status `201`
  - the `allOf[subschema #2]/data/items/items/transferId` response's property format changed from `uuid` to no format for status `201`
  - the `allOf[subschema #2]/data/pendingCount` response's property type changed from `integer` to `number` for status `201`
  - the `allOf[subschema #2]/data/splitCount` response's property type changed from `integer` to `number` for status `201`
  - the `allOf[subschema #2]/data/successfulCount` response's property type changed from `integer` to `number` for status `201`
  - removed `#/components/schemas/InitiateTransferRequest, subschema #2` from the request body `allOf` list
  - removed the optional property `allOf[subschema #2]/data/beneficiary/currency` from the response with the `201` status
  - added the new `ASSET_MFB` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `ASSET_MFB` enum value to the `allOf[subschema #2]/data/rail` response property for the response status `201`
  - added the new `CHOICE` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `COLLECTED` enum value to the `allOf[subschema #2]/data/items/items/status` response property for the response status `201`
  - added the new `FAILED` enum value to the `allOf[subschema #2]/data/items/items/status` response property for the response status `201`
  - added the new `FLUTTERWAVE` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `IN_REVIEW` enum value to the `allOf[subschema #2]/data/items/items/status` response property for the response status `201`
  - added the new `MANUAL_OTC` enum value to the `allOf[subschema #2]/data/rail` response property for the response status `201`
  - added the new `MOMENTPAY` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `PAGA` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `PAWAPAY` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `PAWAPAY` enum value to the `allOf[subschema #2]/data/rail` response property for the response status `201`
  - added the new `PAYSTACK` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `PAYSTACK` enum value to the `allOf[subschema #2]/data/rail` response property for the response status `201`
  - added the new `PENDING` enum value to the `allOf[subschema #2]/data/items/items/status` response property for the response status `201`
  - added the new `PROVIDUS_BANK` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `REVERSAL` enum value to the `allOf[subschema #2]/data/items/items/status` response property for the response status `201`
  - added the new `STERLING` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `STITCH` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `STRIPE` enum value to the `allOf[subschema #2]/data/provider` response property for the response status `201`
  - added the new `STRIPE` enum value to the `allOf[subschema #2]/data/rail` response property for the response status `201`
  - added the new `SUCCESS` enum value to the `allOf[subschema #2]/data/items/items/status` response property for the response status `201`
  - …54 more

---

[Operation](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api/docs/v1/va/transfer/bulk/post.md) - [API](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api.md) - [Page](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api/changes/v1/va/transfer/bulk/post)