> For the complete documentation index, see [llms.txt](https://docs.vpay.africa/vpay-api-specification-basic-gude/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vpay.africa/vpay-api-specification-basic-gude/methods/outbound-transfer.md).

# outbound transfer

{% hint style="danger" %}
This endpoint is throttled to 1 request every 200 milliseconds.
{% endhint %}

Request

<table><thead><tr><th width="196.5">Method</th><th>URL</th></tr></thead><tbody><tr><td><mark style="color:yellow;"><strong>POST</strong></mark></td><td><mark style="color:blue;"><strong>{{baseUrl}}</strong>/api/service/v1/query/transfer/outbound</mark></td></tr></tbody></table>

<table><thead><tr><th width="195.5">Header</th><th width="344">Value</th><th></th></tr></thead><tbody><tr><td>Content-Type</td><td>application/json</td><td></td></tr><tr><td>publicKey</td><td>{{publicKey}}</td><td></td></tr><tr><td>b-access-token</td><td>{{accessToken}}</td><td>Use the accessToken that was given in response to <mark style="color:green;">/api/service/v1/query/merchant/login</mark></td></tr></tbody></table>

<table><thead><tr><th>Request Body</th><th width="345.66666666666663">Description</th><th></th></tr></thead><tbody><tr><td>nuban</td><td>Beneficiary bank account number to transfer to</td><td>Mandatory</td></tr><tr><td>bank_code</td><td>Beneficiary bank account code to transfer to</td><td>Mandatory</td></tr><tr><td>amount</td><td>Value to be transferred</td><td>Mandatory</td></tr><tr><td>remark</td><td>Transaction narrative/description</td><td><mark style="color:red;">Optional</mark></td></tr><tr><td>transaction_ref</td><td>Transaction reference (merchant prefix - random string)</td><td>Mandatory</td></tr></tbody></table>