---
title: "Initiate transfer"
method: POST
path: "/v1/transfer"
tags: ["Transfers"]
---

# Initiate transfer

`POST /v1/transfer`

## Request body

- InitiateTransferRequest
  - `beneficiary` CreateBeneficiaryRequest
    - `accountName` string, required
    - `accountNumber` string, required
    - `bankName` string, required
    - `bankCode` string, required
    - `currency` 'NGN' | 'GHS' | 'KES', required
    - `description` string
    - `bvn` string
    - `nameEnqRef` string
  - `beneficiaryId` string, uuid
  - `currency` 'NGN' | 'GHS' | 'KES', required
  - `amount` number, required
  - `narration` string, required

## Response `201`

Transfer initiated.

- InitiateTransferResponse
  - `status` boolean
  - `message` string
  - `code` integer
  - `data` unknown

---

[API](https://skmtc.net/kyshi/apis/kyshi-mor-public-api.md) · [All operations](https://skmtc.net/kyshi/apis/kyshi-mor-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kyshi/kyshi-mor-public-api/versions/3c46fabe8df7/schema)