---
title: Balance
description: View the current balance for a Shopify Payments account
api_version: 2026-07
source_url:
  html: 'https://shopify.dev/docs/api/admin-rest/latest/resources/balance'
  md: 'https://shopify.dev/docs/api/admin-rest/latest/resources/balance.md'
api_name: admin-rest
api_type: rest
---

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate).

# Balance

**Requires ANY of the following access scopes: \`shopify\_payments\_payouts\`, \`shopify\_payments\_accounts\`.:**

The account's current balance. This amount is comprised of any [Transaction](https://shopify.dev/docs/admin-api/rest/reference/shopify_payments/transaction) not yet included in a [Payout](https://shopify.dev/docs/admin-api/rest/reference/shopify_payments/payout).

\#

## Endpoints

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/balance.md#get-shopify-payments-balance)

  [/admin/api/latest/shopify\_​payments/balance.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/balance.md#get-shopify-payments-balance)

  Return the current balance

  [shopifyPaymentsAccount](https://shopify.dev/docs/api/admin-graphql/latest/queries/shopifyPaymentsAccount?example=return-the-current-balance)

***

## The Balance resource

### Properties

***

balance

->[balance](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsAccount#field-ShopifyPaymentsAccount.fields.balance)

The account's current balance which contains the following properties:

* `amount`: The balance amount.
* `currency`: Three letter currency code ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format).

***

{}

## The Balance resource

```json
{
  "balance": [
    {
      "amount": "22.56",
      "currency": "USD"
    }
  ]
}
```

***

## getReturn the current balance

[shopifyPaymentsAccount](https://shopify.dev/docs/api/admin-graphql/latest/queries/shopifyPaymentsAccount?example=return-the-current-balance)

Retrieves the account's current balance.

### Parameters

***

api\_version

**string**

**required**

***

### Examples

### Retrieves the account's current balance.

get

## /admin/api/2026-07/shopify\_​payments/balance.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/shopify_payments/balance.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "balance": [
    {
      "amount": "53.99",
      "currency": "USD"
    }
  ]
}
```

### examples

* #### Retrieves the account's current balance.

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/shopify_payments/balance.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"balance":[{"amount":"53.99","currency":"USD"}]}
  ```