Balance

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/stripe/main/json-schema/stripe-balance-schema.json",
  "title": "Balance",
  "description": "This is an object representing your Stripe balance. You can retrieve it to see\nthe balance currently on your Stripe account.\n\nYou can also retrieve the balance history, which contains a list of\n[transactions](https://stripe.com/docs/reporting/balance-transaction-types) that contributed to the balance\n(charges, payouts, and so forth).\n\nThe available and pending amounts for each currency are broken down further by\npayment source types.\n\nRelated guide: [Understanding Connect account balances](https://stripe.com/docs/connect/account-balances)",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/stripe-balance-api-openapi.yml#/components/schemas/balance",
  "properties": {
    "available": {
      "description": "Available funds that you can transfer or pay out automatically by Stripe or explicitly through the [Transfers API](https://stripe.com/docs/api#transfers) or [Payouts API](https://stripe.com/docs/api#payouts). You can find the available balance for each currency and payment type in the `source_types` property.",
      "items": {
        "$ref": "#/$defs/balance_amount"
      },
      "type": "array"
    },
    "connect_reserved": {
      "description": "Funds held due to negative balances on connected Custom accounts. You can find the connect reserve balance for each currency and payment type in the `source_types` property.",
      "items": {
        "$ref": "#/$defs/balance_amount"
      },
      "type": "array"
    },
    "instant_available": {
      "description": "Funds that you can pay out using Instant Payouts.",
      "items": {
        "$ref": "#/$defs/balance_amount_net"
      },
      "type": "array"
    },
    "issuing": {
      "$ref": "#/$defs/balance_detail"
    },
    "livemode": {
      "description": "Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.",
      "type": "boolean"
    },
    "object": {
      "description": "String representing the object's type. Objects of the same type share the same value.",
      "enum": [
        "balance"
      ],
      "type": "string"
    },
    "pending": {
      "description": "Funds that aren't available in the balance yet. You can find the pending balance for each currency and each payment type in the `source_types` property.",
      "items": {
        "$ref": "#/$defs/balance_amount"
      },
      "type": "array"
    }
  },
  "required": [
    "available",
    "livemode",
    "object",
    "pending"
  ],
  "type": "object",
  "x-expandableFields": [
    "available",
    "connect_reserved",
    "instant_available",
    "issuing",
    "pending"
  ],
  "x-resourceId": "balance"
}