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

# TransferBalance

`POST /v2/TransferBalance`

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.net/myfatoorah/apis/myfatoorah-api-v3.md) · [All operations](https://skmtc.net/myfatoorah/apis/myfatoorah-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myfatoorah/myfatoorah-api-v3/revisions/994a74287a16/schema)