This is an object representing your Stripe balance. You can retrieve it to see the balance currently on your Stripe account. You can also retrieve the balance history, which contains a list of transactions that contributed to the balance (charges, payouts, and so forth).
Stripe Balance API is one of 159 APIs that Stripe publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Balances, History, and Transaction. The published artifact set on APIs.io includes API documentation, an API reference, and an OpenAPI specification.
This API exposes
14 operations
across 11 paths,
and defines 32 schemas.
It is described by OpenAPI 3.2.0, at version 2023-10-16.
Requests are made against a single base URL, https://api.stripe.com/.
14 operations11 paths32 schemas10 GET4 POST
Metadata
The identity and technical contract details declared by the specification.
Stripe Balance API declares
2 security schemes
for authenticating requests.
It accepts HTTP basic authentication (basicAuth).
It accepts HTTP bearer tokens (auth-scheme) (bearerAuth).
By default, every request must be authenticated.
Across 11 paths, the API surfaces 14 operations — 10 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.
Balance 14
GET
/v1/balance
Retrieves the current account balance, based on the authentication that was used to make the request. For a sample request, see Accounting for negative balances .
GetBalance1 parambody→ 200default
GET
/v1/balance/history
Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth). The transactions are returned in sorted order, with the most recent transa…
GetBalanceHistory9 paramsbody→ 200default
GET
/v1/balance/history/{id}
Retrieves the balance transaction with the given ID. Note that this endpoint previously used the path /v1/balance/history/:id .
GetBalanceHistoryId2 paramsbody→ 200default
GET
/v1/balance_transactions
Stripe Get Balance Transactions
getBalanceTransactions9 paramsbody→ 200default
GET
/v1/balance_transactions/{id}
Stripe Get Balance Transactions Id
getBalanceTransactionsId2 paramsbody→ 200default
GET
/v1/customers/{customer}/balance_transactions
Stripe Get Customers Customer Balance Transactions
The contract defines 32 schemas that model the data the API accepts and returns. The most detailed are subscription (43 properties), payment_method (43 properties), payment_intent (39 properties), card (28 properties). Each schema is shown below with its type and property counts.
customer
object
This object represents a customer of your business. Use it to create recurring charges and track payments that belong to the same customer. Related guide: [Sav…
28 properties4 required
balance
object
This is an object representing your Stripe balance. You can retrieve it to see the balance currently on your Stripe account. You can also retrieve the balance…
7 properties4 required
GetCustomersCustomerBalanceTransactionsRequest
object
CustomerCashBalanceTransactionList
object
4 properties4 required
payment_method
object
PaymentMethod objects represent your customer's payment instruments. You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) t…
43 properties6 required
subscription
object
Subscriptions allow you to charge a customer on a recurring basis. Related guide: [Creating subscriptions](https://stripe.com/docs/billing/subscriptions/creati…
43 properties16 required
payment_intent
object
A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each orde…
You can store multiple cards on a customer in order to charge the customer later. You can also store multiple debit cards on a recipient in order to transfer t…
You can add one or multiple tax IDs to a [customer](https://stripe.com/docs/api/customers) or account. Customer and account tax IDs get displayed on related in…
Customers with certain payments enabled have a cash balance, representing funds that were paid by the customer to a merchant, but have not yet been allocated t…
15 properties9 required
bank_account
object
These bank accounts are payment methods on Customer objects. On the other hand [External Accounts](https://stripe.com/docs/apiexternalaccounts) are transfer de…
19 properties6 required
balance_transaction
object
Balance transactions represent funds moving through your Stripe account. Stripe creates them for every type of transaction that enters or leaves your Stripe ac…
15 properties12 required
customer_balance_transaction
object
Each customer has a [Balance](https://stripe.com/docs/api/customers/objectcustomerobject-balance) value, which denotes a debit or credit that's automatically a…
A discount represents the actual application of a [coupon](https://stripe.com/docs/apicoupons) or [promotion code](https://stripe.com/docs/apipromotioncodes).…
11 properties4 required
cash_balance
object
A customer's Cash balance represents real funds. Customers can add funds to their cash balance by sending a bank transfer. These funds can be used for payment…
5 properties4 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Stripe Balance API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
