--- title: "Get Billing Details" method: GET path: "/billing" tags: ["Billing"] --- # Get Billing Details `GET /billing` ## Request - Base URL: `https://api.bunny.net` - URL: `https://api.bunny.net/billing` - Auth: one of: - API key in header `AccessKey` - API key in header `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) Get the billing status details ## Response `200` Get the billing status details - BillingModel - `Balance` number, double: The current account balance - `ThisMonthCharges` number, double: The current account charges of the running month - `LastRechargeBalance` number, double: Last recharge amount balance - `AvailableBalance` number, double: The current account balance plus available (unexpired) coupon credit - `CouponBalance` number: All available (unexpired) coupon money on the account - `MonthlyCouponUsage` number: The total coupon credit used this month across all services - `BillingRecords` BillingRecordModel[], nullable: The list of billing records for this account - `Id` integer: The ID of the billing record - `PaymentId` string, nullable: The external ID of the payment - `Amount` number, double: The amount linked to the record model - `Payer` string, nullable: The payer reference that sent the payment - `Timestamp` string, date-time: The date and time when the billing record was created - `Type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7: 0 = PayPal 1 = Crypto 2 = Credit Card 3 = Monthly Usage 4 = Refund 5 = Coupon Code 6 = Bank Transfer 7 = Affiliate Credits - `InvoiceAvailable` boolean: Determines if an invoice is available - `DocumentDownloadUrl` string, nullable: The URL where the invoice or document can be downloaded. Null if this is not available. - `DetailedDocumentDownloadUrl` string, nullable: The URL where the document with product usage breakdown can be downloaded. Null if this is not available. - `BillingHistoryChart` object, nullable: The constructed billing history chart data - `MonthlyChargesEUTraffic` number, double: The total charges this month paid for European traffic - `MonthlyChargesUSTraffic` number, double: The total charges this month paid for North American traffic - `MonthlyChargesASIATraffic` number, double: The total charges this month paid for Asian and Oceanian traffic - `MonthlyChargesAFTraffic` number, double: The total charges this month paid for African traffic - `MonthlyChargesSATraffic` number, double: The total charges this month paid for South American traffic - `MonthlyChargesStorage` number, double: The total charges this month paid for Edge Storage - `MonthlyChargesDNS` number, double: The total monthly charges for Bunny DNS - `MonthlyChargesOptimizer` number, double: The monthly charges caused by optimizer. - `MonthlyChargesTranscribe` number, double: The total monthly charges for Bunny Stream Transcribe - `MonthlyChargesPremiumEncoding` number: The total monthly charges for Bunny Stream Premium Encoding - `MonthlyChargesExtraPullZones` number, double: The monthly charges caused by extra pull zones. - `MonthlyChargesExtraStorageZones` number, double: The monthly charges caused by extra storage zones. - `MonthlyChargesExtraDnsZones` number, double: The monthly charges caused by extra DNS zones. - `MonthlyChargesExtraVideoLibraries` number, double: The monthly charges caused by extra video libraries. - `MonthlyChargesScripting` number, double: The total monthly charges for Bunny Edge Scripting - `MonthlyChargesScriptingRequests` number, double: The total monthly charges for Bunny Edge Scripting Requests - `MonthlyChargesScriptingCpu` number, double: The total monthly charges for Bunny Edge Scripting CPU usage - `MonthlyChargesDrm` number, double: The total monthly charges for DRM - `MonthlyChargesMagicContainers` number: The total monthly charges for Magic Containers - `MonthlyMcCpu` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyMcMemory` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyMcIp` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyMcIngressTraffic` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyMcEgressTraffic` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyMcVolumes` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyChargesShield` number: The total monthly charges for Shield - `MonthlyChargesTaxes` number: The total monthly charges for Taxes - `MonthlyChargesWebSockets` number: The total monthly charges for WebSockets - `MonthlyChargesDB` number: The total monthly charges for DB - `MonthlyChargesLoadBalancer` number: The total monthly charges for Load Balancer - `MonthlyDBWrites` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyDBReads` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyDBStorage` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyDBReplica` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyChargesAiGateway` number: The total monthly charges for AI Gateway - `MonthlyAiGatewayInputTokens` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyAiGatewayOutputTokens` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyAiGatewayCachedTokens` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyAiGatewayOtherCharges` UsageBreakdown - `Usage` number: The usage based charge in USD - `TotalUnits` integer: The billed quantity for the related product - `MeasuringUnit` string, nullable: Measuring Unit for TotalUnits (e.g. Rows, GB, Seconds, Bytes, Block-seconds) - `MonthlyBandwidthUsed` integer: Total bandwidth used by the account during this month. - `MonthlyDnsSmartQueriesServed` integer: Total number of Bunny DNS smart queries served this month. - `MonthlyDnsNormalQueriesServed` integer: Total number of Bunny DNS normal queries served this month. - `MonthlyTranscriptionMinutes` integer: Total minutes used for Bunny Stream Transcribe this month. - `MonthlyPremiumEncodingBillableMinutes` integer: Total billable minutes used for Bunny Stream Premium Encoding this month. - `MonthlyDRMLicensesIssued` integer: DRM (enterprise) licenses issued this month. - `MonthlyScriptingRequests` integer: Total number of edge script requests this month. - `MonthlyScriptingCpuTime` integer: Total edge script CPU time (milliseconds) used this month. - `BillingEnabled` boolean: Determines if billing is currently enabled for this user. - `MinimumMonthlyCommit` number, double: Determines the minimum monthly commit of the user. - `VATRate` number: The VAT rate for the user's account. - `NextMonthVATRate` number: Next month VAT rate for the user's account. - `AutomaticPaymentImageUrl` string, nullable: If an automatic payment method is configured, this will contain the image url of the payment method - `AutomaticPaymentCardType` string, nullable: If an automatic payment method is configured with a credit card, this will contain the name of the payment credit card - `AutomaticPaymentIdentifier` string, nullable: If an automatic payment method is configured, this will contain the identifier of the payment method - `AutomaticPaymentAmount` number: If an automatic payments are configured, this contains the payment amount that will be made during an automatic recharge - `AutomaticRechargeTreshold` number: If an automatic payments are configured, this contains the account balance amount that will trigger an automatic recharge - `AutomaticRechargeEnabled` boolean: Determines if automatic recharge is currently enabled. - `AutomaticPaymentFailureCount` integer: Determines the number of failed automatic recharges that the system made since the last successful payment. - `SavedPaymentMethods` BillingSavedPaymentMethod[], nullable: Contains the list of saved payment methods on the user's account - `Token` string, nullable - `ImageUrl` string, nullable - `ExpirationDate` string, nullable - `LastFour` string, nullable - `Email` string, nullable - `EUUSDiscount` integer: The account wide pricing discount for EU and US region. - `SouthAmericaDiscount` integer: The account wide pricing discount for South America region. - `AfricaDiscount` integer: The account wide pricing discount for Africa region. - `AsiaOceaniaDiscount` integer: The account wide pricing discount for Asia & Oceania region. - `OptimizerMonthlyPrice` number: Optimizer monthly price per pull zone for this account (unless overridden on pull zone level). - `DrmBaseMonthlyPrice` number: DRM (Enterprise) base monthly price per video library. - `DrmCostPerLicense` number, nullable: DRM (Enterprise) cost per license or default pricing tier applied if null. ## Other responses - `401`: The request authorization failed - `500`: Internal Server Error ## Changes - **2026-10-27** `2096a6606d8d`: 7 info - the security scope `ScopedApiKey` was added to the endpoint's security scheme `AccessKey` - the security scope `ScopedApiKey` was added to the endpoint's security scheme `bearer` - added the optional property `MonthlyAiGatewayCachedTokens` to the response with the `200` status - added the optional property `MonthlyAiGatewayInputTokens` to the response with the `200` status - …3 more - **2026-08-07** `205129a7ebd5`: 4 breaking, 14 info - added `#/components/schemas/UsageBreakdown` to the `MonthlyDBReads` response property `oneOf` list for the response status `200` - added `#/components/schemas/UsageBreakdown` to the `MonthlyDBReplica` response property `oneOf` list for the response status `200` - added `#/components/schemas/UsageBreakdown` to the `MonthlyDBStorage` response property `oneOf` list for the response status `200` - added `#/components/schemas/UsageBreakdown` to the `MonthlyDBWrites` response property `oneOf` list for the response status `200` - …14 more [Operation history](https://skmtc.dev/bunny/apis/bunny-net-api/changes/billing/get.md) --- [API](https://skmtc.dev/bunny/apis/bunny-net-api.md) - [All operations](https://skmtc.dev/bunny/apis/bunny-net-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/bunny-net-api/revisions/2b06f94dbfbf?raw)