--- title: Billing --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Organizations](https://developers.cloudflare.com/api/python/resources/organizations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Billing #### BillingUsage ##### [Get Organization Usage (Version 2, Alpha, Restricted)](https://developers.cloudflare.com/api/python/resources/organizations/subresources/billing/subresources/usage/methods/get) organizations.billing.usage.get(strorganization\_id, UsageGetParams\*\*kwargs) -> [UsageGetResponse]() GET/organizations/{organization\_id}/billable/usage ##### ModelsExpand Collapse
List\[UsageGetResponseItem] Contains the array of cost and usage records. charge\_category: Literal\["Usage"] Highest-level classification of a charge based on the nature of how it gets billed. Currently only “Usage” is supported. Link to this property charge\_description: str Self-contained summary of the charge’s purpose and price. Link to this property charge\_frequency: Literal\["Usage-Based"] Indicates how often a charge occurs. Currently only “Usage-Based” is supported. Link to this property charge\_period\_end: datetime Exclusive end of the time interval during which the usage was consumed. formatdate-time Link to this property charge\_period\_start: datetime Inclusive start of the time interval during which the usage was consumed. formatdate-time Link to this property consumed\_quantity: float Measured usage amount within the charge period. Reflects raw metered consumption before pricing transformations. Link to this property consumed\_unit: str Unit of measure for the consumed quantity (e.g., “GB”, “Requests”, “vCPU-Hours”). Link to this property host\_provider\_name: str Name of the entity providing the underlying infrastructure or platform. Link to this property invoice\_issuer\_name: str Name of the entity responsible for invoicing for the services consumed. Link to this property service\_provider\_name: str Name of the entity that made the services available for purchase. Link to this property x\_billable\_metric\_id: str The unique identifier for the billable metric in the Cloudflare catalog. Cloudflare extension; replaces FOCUS SkuId. Link to this property billed\_cost: Optional\[float] A charge serving as the basis for invoicing, inclusive of all reduced rates and discounts while excluding the amortization of upfront charges (one-time or recurring). Link to this property billing\_account\_id: Optional\[str] Public identifier of the Cloudflare account (account tag). Omitted when account is not part of the requested grouping, and always omitted for usage measured at contract level, even when grouping by account: that usage is returned as its own record with no account. Link to this property billing\_account\_name: Optional\[str] Display name of the Cloudflare account. Omitted when account is not part of the requested grouping, and for usage measured at contract level. Link to this property billing\_currency: Optional\[str] Currency that a charge was billed in (ISO 4217). Link to this property billing\_period\_end: Optional\[datetime] Exclusive end of the billing cycle that contains this usage record. formatdate-time Link to this property billing\_period\_start: Optional\[datetime] Inclusive start of the billing cycle that contains this usage record. formatdate-time Link to this property charge\_class: Optional\[Literal\["Correction"]] Indicates whether the row represents a correction to one or more charges invoiced in a previous billing period. Link to this property contracted\_cost: Optional\[float] Cost calculated by multiplying ContractedUnitPrice and the corresponding PricingQuantity. Link to this property contracted\_unit\_price: Optional\[float] The agreed-upon unit price for a single PricingUnit of the associated billable metric, inclusive of negotiated discounts, if present, while excluding any other discounts. Link to this property effective\_cost: Optional\[float] The amortized cost of the charge after applying all reduced rates, discounts, and the applicable portion of relevant, prepaid purchases (one-time or recurring) that covered the charge. Link to this property list\_cost: Optional\[float] Cost calculated by multiplying ListUnitPrice and the corresponding PricingQuantity. Link to this property list\_unit\_price: Optional\[float] Suggested provider-published unit price for a single PricingUnit of the associated billable metric, exclusive of any discounts. Link to this property pricing\_quantity: Optional\[float] Volume of a given service used or purchased, based on the PricingUnit. Link to this property pricing\_unit: Optional\[str] Provider-specified measurement unit for determining unit prices, indicating how the provider rates measured usage after applying pricing rules like block pricing. Link to this property region\_id: Optional\[str] Provider-assigned identifier for an isolated geographic area where a service is provided. Link to this property region\_name: Optional\[str] Name of an isolated geographic area where a service is provided. Link to this property sub\_account\_id: Optional\[str] Unique identifier assigned to a grouping of services. For Cloudflare, this is the subscription or contract ID. Link to this property sub\_account\_name: Optional\[str] Name assigned to a grouping of services. For Cloudflare, this is the subscription or contract display name. Link to this property
tags: Optional\[Dict\[str, Union\[str, Literal\[true]]]] Tag values for the requested GroupBy keys. Omitted when GroupBy is not provided. Missing keys are omitted, and key-only tags are returned as boolean true. All other tag values are strings. One of the following: str Link to this property Literal\[true] Link to this property
Link to this property x\_billable\_metric\_name: Optional\[str] The display name of the billable metric. Cloudflare extension; replaces FOCUS SkuMeter. Link to this property x\_product\_category\_name: Optional\[str] The product category the charge belongs to (e.g., “Developer”, “Cloudflare One”). Cloudflare extension; replaces FOCUS ServiceCategory. Link to this property x\_product\_family\_id: Optional\[str] The unique identifier for the product family in the Cloudflare catalog. Cloudflare extension; replaces FOCUS ServiceId. Link to this property x\_product\_family\_name: Optional\[str] The product family the charge belongs to (e.g., “R2”, “Workers”). Cloudflare extension; replaces FOCUS ServiceName. Link to this property x\_zone\_id: Optional\[str] The identifier for the Cloudflare zone (zone tag). Omitted when zone is not part of the requested grouping, and always omitted for usage measured at contract level, even when grouping by zone. Cloudflare extension. Link to this property x\_zone\_name: Optional\[str] The display name of the Cloudflare zone. Omitted when zone is not part of the requested grouping, and for usage measured at contract level. Cloudflare extension. Link to this property
[Link to this property](<#(resource)%20organizations.billing.usage%20%3E%20(model)%20usage_get_response%20%3E%20(schema)>)