# GetBalanceHistoryId From **Stripe API**. `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.

## Parameters ### `expand` - Location: query - Required: false - Type: `array` Specifies which fields in the response should be expanded. ### `id` - Location: path - Required: true - Type: `string` - maxLength: `5000` ## Request body - Required: false ### `application/x-www-form-urlencoded` - Type: `object` ```json {"additionalProperties":false,"type":"object"} ``` ## Security ### `basicAuth` - Type: `http` - Request header: `Authorization` - Scheme: `basic` Send credentials in the `Authorization` request header using the `Basic` scheme. Basic HTTP authentication. Allowed headers-- Authorization: Basic | Authorization: Basic ### `bearerAuth` - Type: `http` - Request header: `Authorization` - Scheme: `bearer` - Bearer format: `auth-scheme` Send the token in the `Authorization` request header using the `Bearer` scheme. Bearer HTTP authentication. Allowed headers-- Authorization: Bearer ## Responses ### `200` Successful response. ### `application/json` - Type: `object` Balance transactions represent funds moving through your Stripe account. They're created for every type of transaction that comes into or flows out of your Stripe account balance. Related guide: [Balance Transaction Types](https://stripe.com/docs/reports/balance-transaction-types). ```json {"description":"Balance transactions represent funds moving through your Stripe account.\nThey're created for every type of transaction that comes into or flows out of your Stripe account balance.\n\nRelated guide: [Balance Transaction Types](https://stripe.com/docs/reports/balance-transaction-types).","properties":{"amount":{"description":"Gross amount of the transaction, in %s.","type":"integer"},"available_on":{"description":"The date the transaction's net funds will become available in the Stripe balance.","format":"unix-time","type":"integer"},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"currency":{"description":"Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).","type":"string"},"description":{"description":"An arbitrary string attached to the object. Often useful for displaying to users.","maxLength":5000,"nullable":true,"type":"string"},"exchange_rate":{"description":"The exchange rate used, if applicable, for this transaction. Specifically, if money was converted from currency A to currency B, then the `amount` in currency A, times `exchange_rate`, would be the `amount` in currency B. For example, suppose you charged a customer 10.00 EUR. Then the PaymentIntent's `amount` would be `1000` and `currency` would be `eur`. Suppose this was converted into 12.34 USD in your Stripe account. Then the BalanceTransaction's `amount` would be `1234`, `currency` would be `usd`, and `exchange_rate` would be `1.234`.","nullable":true,"type":"number"},"fee":{"description":"Fees (in %s) paid for this transaction.","type":"integer"},"fee_details":{"description":"Detailed breakdown of fees (in %s) paid for this transaction.","items":{"$ref":"#/components/schemas/fee"},"type":"array"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"net":{"description":"Net amount of the transaction, in %s.","type":"integer"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["balance_transaction"],"type":"string"},"reporting_category":{"description":"[Learn more](https://stripe.com/docs/reports/reporting-categories) about how reporting categories can help you understand balance transactions from an accounting perspective.","maxLength":5000,"type":"string"},"source":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/application_fee"},{"$ref":"#/components/schemas/charge"},{"$ref":"#/components/schemas/connect_collection_transfer"},{"$ref":"#/components/schemas/dispute"},{"$ref":"#/components/schemas/fee_refund"},{"$ref":"#/components/schemas/issuing.authorization"},{"$ref":"#/components/schemas/issuing.dispute"},{"$ref":"#/components/schemas/issuing.transaction"},{"$ref":"#/components/schemas/payout"},{"$ref":"#/components/schemas/platform_tax_fee"},{"$ref":"#/components/schemas/refund"},{"$ref":"#/components/schemas/reserve_transaction"},{"$ref":"#/components/schemas/tax_deducted_at_source"},{"$ref":"#/components/schemas/topup"},{"$ref":"#/components/schemas/transfer"},{"$ref":"#/components/schemas/transfer_reversal"}],"description":"The Stripe object to which this transaction is related.","nullable":true,"x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/application_fee"},{"$ref":"#/components/schemas/charge"},{"$ref":"#/components/schemas/connect_collection_transfer"},{"$ref":"#/components/schemas/dispute"},{"$ref":"#/components/schemas/fee_refund"},{"$ref":"#/components/schemas/issuing.authorization"},{"$ref":"#/components/schemas/issuing.dispute"},{"$ref":"#/components/schemas/issuing.transaction"},{"$ref":"#/components/schemas/payout"},{"$ref":"#/components/schemas/platform_tax_fee"},{"$ref":"#/components/schemas/refund"},{"$ref":"#/components/schemas/reserve_transaction"},{"$ref":"#/components/schemas/tax_deducted_at_source"},{"$ref":"#/components/schemas/topup"},{"$ref":"#/components/schemas/transfer"},{"$ref":"#/components/schemas/transfer_reversal"}]},"x-stripeBypassValidation":true},"status":{"description":"If the transaction's net funds are available in the Stripe balance yet. Either `available` or `pending`.","maxLength":5000,"type":"string"},"type":{"description":"Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `payment`, `payment_failure_refund`, `payment_refund`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. [Learn more](https://stripe.com/docs/reports/balance-transaction-types) about balance transaction types and what they represent. If you are looking to classify transactions for accounting purposes, you might want to consider `reporting_category` instead.","enum":["adjustment","advance","advance_funding","anticipation_repayment","application_fee","application_fee_refund","charge","connect_collection_transfer","contribution","issuing_authorization_hold","issuing_authorization_release","issuing_dispute","issuing_transaction","payment","payment_failure_refund","payment_refund","payout","payout_cancel","payout_failure","refund","refund_failure","reserve_transaction","reserved_funds","stripe_fee","stripe_fx_fee","tax_fee","topup","topup_reversal","transfer","transfer_cancel","transfer_failure","transfer_refund"],"type":"string"}},"required":["amount","available_on","created","currency","fee","fee_details","id","net","object","reporting_category","status","type"],"title":"BalanceTransaction","type":"object","x-expandableFields":["fee_details","source"],"x-resourceId":"balance_transaction"} ``` ### `default` Error response. ### `application/json` - Type: `object` An error response from the Stripe API ```json {"description":"An error response from the Stripe API","properties":{"error":{"$ref":"#/components/schemas/api_errors"}},"required":["error"],"type":"object"} ``` ## Request examples ### cURL ```shell curl --request GET \ --url https://api.stripe.com/v1/balance/history/{id} \ --header 'content-type: application/x-www-form-urlencoded' \ --data '{}' ```