---
title: "Retrieve your balance and last transaction date"
method: GET
path: "/merchants/{merchantId}/balance"
tags: ["Balance"]
---

# Retrieve your balance and last transaction date

`GET /merchants/{merchantId}/balance`

Ensure that you have enough available balance before executing a create payout request.

For more information, see the [documentation](https://developer.peachpayments.com/docs/payouts-api-1#retrieve-your-balance-and-last-transaction-date-flow), and for sample calls, see the [public Postman collection](https://www.postman.com/peachpayments/peach-payments-public-workspace/request/ge0mylf/retrieve-balance?ctx=documentation).

## Path parameters

- `merchantId` string, required — A unique merchant ID provided by Peach Payments in hexadecimal format.

## Response `200`

The 200 response returns an object containing the current balance, the last recognised transaction date, and the currency.

- object — A response object containing the available balance, last transaction date, and currency.
  - `currency` 'ZAR' — A three-letter currency code (ISO 4217). ZAR is supported for Tyme payouts.
  - `availableBalance` number — The available balance represented in the minor currency (that is, cents) where 32123 is 321.23 in the major currency.
  - `lastTransactionDate` string, date-time — The ISO-8601 timestamp of your last transaction.

## Other responses

- `400` — There was an error with the request. Please fix the request and try again.
- `401` — The request is not authenticated. Please re-authenticate and provide a new token.
- `403` — The request is not authorised. Please contact your business administrator.
- `404` — No last balance was found on your account.

---

[API](https://skmtc.net/peachpayments/apis/checkout.md) · [All operations](https://skmtc.net/peachpayments/apis/checkout/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peachpayments/checkout/revisions/3a98165665f8/schema)