--- title: Get Account Billable Usage (Version 1, Alpha) --- [Skip to content](#%5Ftop) [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](https://developers.cloudflare.com/api/python/resources/billing#%28resource%29%20billing.usage%20%3E%20%28model%29%20usage%5Fget%5Faccount%5Fusage%5Fv1%5Fresponse%20%3E%20%28schema%29) 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](https://developers.cloudflare.com/fundamentals/api/get-started/create-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 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 to: Optional\[Union\[null, null\]\] End date for the usage query (ISO 8601). formatdate ##### 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. billing\_account\_id: str The identifier of the account the charge is billed to (account tag). billing\_account\_name: Optional\[str\] The display name of the billing account. Null when the name could not be resolved. billing\_currency: str Specifies the billing currency code (ISO 4217). 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 charge\_category: Literal\["Usage"\] Describes the nature of the charge. Always “Usage” for this endpoint, which only returns metered usage. charge\_class: Optional\[str\] Indicates whether the row corrects a previously invoiced billing period. Always null for this endpoint, which does not return corrections. charge\_description: Optional\[str\] A human-readable summary of the charge. charge\_period\_end: datetime Indicates the end of the charge period. formatdate-time charge\_period\_start: datetime Indicates the start of the charge period. formatdate-time consumed\_quantity: float Specifies the quantity consumed during this charge period. 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. contracted\_cost: float Specifies the cost for this charge period in the billing currency. cumulated\_contracted\_cost: float Specifies the cumulated cost for the billing period in the billing currency. cumulated\_pricing\_quantity: int Specifies the portion of usage that is actually subject to a unit price. effective\_cost: float The amortized cost of the charge. PayGo has no upfront commitments, so this equals ContractedCost. host\_provider\_name: str The provider that hosts the infrastructure or platform the service runs on. invoice\_issuer\_name: str The entity that issues the invoice for this charge. list\_cost: float The cost at published list prices, before any discount. PayGo has no commitment discounts, so this equals ContractedCost. pricing\_quantity: int Specifies the pricing quantity for this charge period. 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. service\_name: str Identifies the Cloudflare service. service\_provider\_name: str The provider of the purchased service. service\_family\_name: Optional\[str\] Identifies the product family for the Cloudflare service. subscription\_id: Optional\[str\] The identifier for the Cloudflare subscription. zone\_id: Optional\[str\] The identifier for the Cloudflare zone (zone tag). zone\_name: Optional\[str\] The display name of the Cloudflare zone. ### Get Account Billable Usage (Version 1, Alpha) Python HTTPHTTP TypeScriptTypeScript PythonPython GoGo TerraformTerraform ``` 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 } ```