---
title: "View recipient balance"
method: GET
path: "/payout/v3/recipientBalance"
tags: ["Spendbacks"]
---

# View recipient balance

`GET /payout/v3/recipientBalance`

Allows merchants to view a recipient's spendback balance to ensure sufficient funds are available for spendbacks. Shows the balance for each spendback provider account associated with the `recipientRef` parameter. 

Requires `recipientRef` query parameter to access recipient balance information. This is the same `recipientRef` that is used in the [Submit spendback](https://docs.nexiopay.com/reference/submitspendback) endpoint.

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you must use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments).<br/><br/>Include the `recipientRef` parameter in the request.

<div style="display:none;">

## Request parameters
- recipientRef

## Response parameters
- recipientRef
- recipientBalances
- recipientBalances.recipientId
- recipientBalances.amount
- recipientBalances.currency
- recipientBalances.providerId
- recipientBalances.providerType

</div>

## Query parameters

- `recipientRef` string, required

## Response `200`

OK

- object
  - `recipientRef` RecipientRef — unresolved $ref
  - `recipientBalances` object
    - `recipientId` RecipientId — unresolved $ref
    - `amount` number — The amount. The maximum value has 16 digits total, including up to two of those digits after the decimal point.
    - `currency` string — The [three-digit ISO numeric currency code](https://en.wikipedia.org/wiki/ISO_4217). For information about valid values, see the [currency table](https://docs.nexiopay.com/docs/constant-transaction-values#currency-id-currencyid) in Guides.
    - `providerId` ProviderId — unresolved $ref
    - `providerType` ProviderType — unresolved $ref

## Other responses

- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.

---

[API](https://skmtc.dev/nexiopay/apis/payments-api-reference.md) · [All operations](https://skmtc.dev/nexiopay/apis/payments-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nexiopay/payments-api-reference/revisions/b414b73979e5/schema)