---
title: "Get merchant balance"
method: GET
path: "/v1/marketplaces/{marketplaceId}/merchants/{merchantId}/balance"
tags: ["Balance"]
---

# Get merchant balance

`GET /v1/marketplaces/{marketplaceId}/merchants/{merchantId}/balance`

## Request

- Base URL: `https://sandbox.pismolabs.io/sellers`
- URL: `https://sandbox.pismolabs.io/sellers/v1/marketplaces/{marketplaceId}/merchants/{merchantId}/balance`
- Auth: HTTP bearer

The merchant balance endpoint provides an estimate of the available funds in the merchant account on a specified target date. It takes into account the scheduled merchant transactions in the specified marketplace to calculate the estimated values.

`estimated_available_amount` represents the forecasted amount that might be available to the merchant on the target date, based on the current scheduled transactions. This estimate is subject to change due to cancellations, new transactions, and advancements made by the merchant until the target date arrives.

If the merchant's scheduled balance is negative, the amount accumulates in the `scheduled_amount` field until it becomes positive and is available for settlement. Therefore, a negative `scheduled_amount` is not considered for settlement until it turns positive.

## Path parameters

- `marketplaceId` integer, required
- `merchantId` integer, required

## Query parameters

- `date` string, date

## Headers

- `Authorization` string, required

## Response `200`

Successfully get merchant balance

- BalanceRequestGetResponse
  - `date` string, date: Target date to estimate the merchant balance
  - `current_available_amount` number, float: Amount available in the merchant account. It is always the exact amount in that account, regardless of the target date
  - `estimated_available_amount` number, float: Estimated available amount in the merchant account on the target date. This includes all scheduled amounts that are projected to be settled and available in the merchant account by that date.
  - `scheduled_amount` number, float: Scheduled amount on the target date. The scheduled amount is the amount that is not yet available, but is scheduled to be settled on the target date.
  - `currency_code` string, nullable: ISO 4217 alphanumeric currency code. `null` when no currency is recorded.

## Other responses

- `400`: Bad request
- `404`: Bad request
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/seller-management-transactions.md) - [All operations](https://skmtc.dev/pismo/apis/seller-management-transactions/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/seller-management-transactions/revisions/95ba885d7f40?raw)