---
title: "TransferBalance"
method: POST
path: "/v2/TransferBalance"
tags: ["Supplier"]
---

# TransferBalance

`POST /v2/TransferBalance`

## Request

- Base URL: `https://apitest.myfatoorah.com`
- URL: `https://apitest.myfatoorah.com/v2/TransferBalance`
- Auth: HTTP bearer

Transfers a balance from or to the available balance of a supplier. This endpoint works with a single supplier at each request and is specifically designed for the Multi-Vendors feature.

## Request body

- object
  - `SupplierCode` integer, required: The supplier code you need to associate the invoice with
  - `TransferAmount` number, required: The amount that will be transferred to or from the supplier
  - `TransferType` 'pull' | 'push', required: pull: The balance transfers from supplier to vendor. push: The balance transfers from vendor to supplier
  - `InternalNotes` string: Extra comments for your reference (optional)

## Response `200`

Successful response

- object
  - `IsSuccess` boolean: Indicates if the request was successful
  - `Message` string: Response message
  - `FieldsErrors` unknown[]: List of validation errors if any
    - unknown
  - `Data` object: Balance transfer result
    - `InvoiceId` integer: The invoice ID associated with the balance transfer
    - `Date` string: The date when the balance transfer was completed

---

[API](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v2.md) - [All operations](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v2/revisions/4c0c2a3af558?raw)