# Get Payout Balance

**Method:** `GET`

**Path:** `/payouts/v3/payments/funding-account`

**Category:** Payouts

**Authentication:** Required

## Description

Retrieves the funding account balance linked to your Pine Labs Online
account. This API is only available when you have a funding account
linked to your Pine Labs Online account.


## Header Parameters

- `Request-Timestamp` (`string`) — ISO 8601 UTC timestamp of the request. Used for idempotency and audit.
  - Format: date-time
- `Request-ID` (`string`) — Use a global unique identifier [GUID] for the request.
  - Length: 1–50 characters

## Responses

- `200` — Account balance retrieved successfully.
- `400` — The request was malformed or missing required fields.
- `401` — Authentication failed — missing, expired, or invalid Bearer token.
- `403` — The authenticated client does not have permission for this operation.
- `500` — An unexpected error occurred on the server.

### Response Schema

- `accountNumber` (`string`) — Funding account number.
- `branchCode` (`string`) — IFSC code of the funding account bank.
- `balance` (`object`) — Monetary amount with currency (no min/max constraints). Used for fees, tax, and balance values.
  - `value` (`integer`) **required** — Amount in the smallest currency unit (paisa for INR).
  - `currency` (`string`) **required** — Three-letter ISO 4217 currency code.
    - Default: INR


### Example Response

```json
{
  "accountNumber": "0995300992429",
  "branchCode": "UTIB0001111",
  "balance": {
    "value": 0,
    "currency": "INR"
  }
}
```

---

Reference: https://localhost:3000/api/payouts/get-payout-balance