---
title: "Get Prefund balance"
method: GET
path: "/api/fma/v1/prefund-balance"
tags: ["Cards"]
---

# Get Prefund balance

`GET /api/fma/v1/prefund-balance`

Returns the current state of the Partner's Prefund Account. This endpoint is partner-scoped, not user-scoped; UR maintains one Prefund Account per partner, and the response is a flat, single-currency object for the settlement currency (defaults to USD). Poll at operational dashboard cadence, e.g. no more frequently than once per minute unless UR advises otherwise and do not call it from inside the Card Authorization callback; UR already performs Prefund availability checks before approving.

## Headers

- `X-Api-Signature` string, required
- `X-Api-Deadline` string, required
- `X-Api-PublicKey` string, required

## Response `200`

Current Prefund Account state for the partner's settlement currency. The response does not include a settleMode field; record your configured settlement mode from onboarding.

- CardPrefundBalanceResponse — Standard response envelope for the Prefund balance endpoint. code 0 means success.
  - `code` integer, required — 0 on success; a non-zero value indicates a business rejection.
  - `message` string, required — Human-readable diagnostic; empty on success.
  - `data` CardPrefundBalance, required — Current state of the partner's Prefund Account in its settlement currency.
    - `partnerId` string, required — Partner identifier registered with UR.
    - `account` string, required — On-chain address of the Prefund Account (Mantle).
    - `currency` string, required — The settlement currency, agreed with UR (defaults to USD).
    - `balance` string, required — Current balance, decimal string.
    - `minBalance` string — Minimum balance threshold. prefund.balance.alert fires when the balance reaches or falls below it.
    - `level` 'normal' | 'warning' — Balance level relative to minBalance. This endpoint emits normal (balance above minBalance) or warning (balance at or below minBalance) only.
    - `allowance` string — The card-spend contract allowance for this account, as a human-readable amount.
    - `updatedAt` integer — Unix seconds, last balance update.

---

[API](https://skmtc.net/ur/apis/ur-api.md) · [All operations](https://skmtc.net/ur/apis/ur-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ur/ur-api/revisions/087dcf516ce2/schema)