--- title: Get Account Billable Usage (Version 1, Alpha) --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Billing](https://developers.cloudflare.com/api/python/resources/billing) [Usage](https://developers.cloudflare.com/api/python/resources/billing/subresources/usage) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Account Billable Usage (Version 1, Alpha) billing.usage.get\_account\_usage\_v1(UsageGetAccountUsageV1Params\*\*kwargs) -> [UsageGetAccountUsageV1Response]() GET/accounts/{account\_id}/billable-usage Returns billable usage data for the account. When no query parameters are provided, returns usage for the current billing period. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### ParametersExpand Collapse account\_id: str Represents a Cloudflare resource identifier tag. maxLength32 [Link to this property](<#(resource)%20billing.usage%20%3E%20(method)%20get_account_usage_v1%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) from\_: Optional\[Union\[null, null]] Start date for the usage query (ISO 8601). The provided time range must include the subscription billing cycle anchor day, otherwise no usage data is returned. Use the info endpoint to retrieve the subscription anchor day. formatdate [Link to this property](<#(resource)%20billing.usage%20%3E%20(method)%20get_account_usage_v1%20%3E%20(params)%20default%20%3E%20(param)%20from%20%3E%20(schema)>) to: Optional\[Union\[null, null]] End date for the usage query (ISO 8601). formatdate [Link to this property](<#(resource)%20billing.usage%20%3E%20(method)%20get_account_usage_v1%20%3E%20(params)%20default%20%3E%20(param)%20to%20%3E%20(schema)>) ##### ReturnsExpand Collapse

List\[UsageGetAccountUsageV1ResponseItem] Contains the array of billable usage records.

billed\_cost: float The amount invoiced for this charge. PayGo is billed directly by Cloudflare, so this equals ContractedCost. Link to this property billing\_account\_id: str The identifier of the account the charge is billed to (account tag). Link to this property billing\_account\_name: Optional\[str] The display name of the billing account. Null when the name could not be resolved. Link to this property billing\_currency: str Specifies the billing currency code (ISO 4217). Link to this property billing\_period\_start: datetime Indicates the start of the billing period. There is no BillingPeriodEnd counterpart; see the known gaps described on this schema. formatdate-time Link to this property charge\_category: Literal\["Usage"] Describes the nature of the charge. Always “Usage” for this endpoint, which only returns metered usage. Link to this property charge\_class: Optional\[str] Indicates whether the row corrects a previously invoiced billing period. Always null for this endpoint, which does not return corrections. Link to this property charge\_description: Optional\[str] A human-readable summary of the charge. Link to this property charge\_period\_end: datetime Indicates the end of the charge period. formatdate-time Link to this property charge\_period\_start: datetime Indicates the start of the charge period. formatdate-time Link to this property consumed\_quantity: float Specifies the quantity consumed during this charge period. Link to this property consumed\_unit: str A display name for the unit of measurement used for the product (for example, “GB-months”, “GB-seconds”). May be empty when the unit is implicit in the service name. Link to this property contracted\_cost: float Specifies the cost for this charge period in the billing currency. Link to this property cumulated\_contracted\_cost: float Specifies the cumulated cost for the billing period in the billing currency. Link to this property cumulated\_pricing\_quantity: int Specifies the portion of usage that is actually subject to a unit price. Link to this property effective\_cost: float The amortized cost of the charge. PayGo has no upfront commitments, so this equals ContractedCost. Link to this property host\_provider\_name: str The provider that hosts the infrastructure or platform the service runs on. Link to this property invoice\_issuer\_name: str The entity that issues the invoice for this charge. Link to this property list\_cost: float The cost at published list prices, before any discount. PayGo has no commitment discounts, so this equals ContractedCost. Link to this property pricing\_quantity: int Specifies the pricing quantity for this charge period. Link to this property pricing\_unit: str The unit that PricingQuantity is expressed in. Unlike ConsumedUnit this is never empty; it falls back to “Count” when the service has no explicit unit. Link to this property service\_name: str Identifies the Cloudflare service. Link to this property service\_provider\_name: str The provider of the purchased service. Link to this property service\_family\_name: Optional\[str] Identifies the product family for the Cloudflare service. Link to this property subscription\_id: Optional\[str] The identifier for the Cloudflare subscription. Link to this property zone\_id: Optional\[str] The identifier for the Cloudflare zone (zone tag). Link to this property zone\_name: Optional\[str] The display name of the Cloudflare zone. Link to this property

[Link to this property](<#(resource)%20billing.usage%20%3E%20(model)%20usage_get_account_usage_v1_response%20%3E%20(schema)>) ### Get Account Billable Usage (Version 1, Alpha) Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.billing.usage.get_account_usage_v1( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(response) ``` 200 example ``` { "errors": [ { "message": "message", "code": 0 } ], "messages": [ { "message": "message", "code": 0 } ], "result": [ { "BilledCost": 0.75, "BillingAccountId": "023e105f4ecef8ad9ca31a8372d0c353", "BillingAccountName": "Example Account", "BillingCurrency": "USD", "BillingPeriodStart": "2025-02-01T00:00:00Z", "ChargeCategory": "Usage", "ChargeClass": "ChargeClass", "ChargeDescription": "Workers Standard usage measured in Count", "ChargePeriodEnd": "2025-02-02T00:00:00Z", "ChargePeriodStart": "2025-02-01T00:00:00Z", "ConsumedQuantity": 150000, "ConsumedUnit": "GB-months", "ContractedCost": 0.75, "CumulatedContractedCost": 2.25, "CumulatedPricingQuantity": 4500000, "EffectiveCost": 0.75, "HostProviderName": "Cloudflare, Inc.", "InvoiceIssuerName": "Cloudflare, Inc.", "ListCost": 0.75, "PricingQuantity": 150000, "PricingUnit": "Count", "ServiceName": "Workers Standard", "ServiceProviderName": "Cloudflare, Inc.", "ServiceFamilyName": "Workers", "SubscriptionId": "3F3CD4CQ6N7FXO7IK6NVFJBOYA", "ZoneId": "023e105f4ecef8ad9ca31a8372d0c353", "ZoneName": "example.com" } ], "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "message": "message", "code": 0 } ], "messages": [ { "message": "message", "code": 0 } ], "result": [ { "BilledCost": 0.75, "BillingAccountId": "023e105f4ecef8ad9ca31a8372d0c353", "BillingAccountName": "Example Account", "BillingCurrency": "USD", "BillingPeriodStart": "2025-02-01T00:00:00Z", "ChargeCategory": "Usage", "ChargeClass": "ChargeClass", "ChargeDescription": "Workers Standard usage measured in Count", "ChargePeriodEnd": "2025-02-02T00:00:00Z", "ChargePeriodStart": "2025-02-01T00:00:00Z", "ConsumedQuantity": 150000, "ConsumedUnit": "GB-months", "ContractedCost": 0.75, "CumulatedContractedCost": 2.25, "CumulatedPricingQuantity": 4500000, "EffectiveCost": 0.75, "HostProviderName": "Cloudflare, Inc.", "InvoiceIssuerName": "Cloudflare, Inc.", "ListCost": 0.75, "PricingQuantity": 150000, "PricingUnit": "Count", "ServiceName": "Workers Standard", "ServiceProviderName": "Cloudflare, Inc.", "ServiceFamilyName": "Workers", "SubscriptionId": "3F3CD4CQ6N7FXO7IK6NVFJBOYA", "ZoneId": "023e105f4ecef8ad9ca31a8372d0c353", "ZoneName": "example.com" } ], "success": true } ```