--- title: Get Account Credits --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Billing](https://developers.cloudflare.com/api/python/resources/billing) [Credits](https://developers.cloudflare.com/api/python/resources/billing/subresources/credits) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Account Credits billing.credits.get(CreditGetParams\*\*kwargs) -> [CreditGetResponse]() GET/accounts/{account\_id}/billing/credits Gets the credit balance and eligibility for an account. ##### 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
##### Accepted Permissions (at least one required) `Billing Write``Billing Read` ##### ParametersExpand Collapse account\_id: str Identifier maxLength32 [Link to this property](<#(resource)%20billing.credits%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class CreditGetResponse: … confirmed\_balance\_cents: Optional\[int] The confirmed credit balance in cents. formatint64 Link to this property currency: Optional\[str] Currency of the credit balance. Link to this property days\_remaining: Optional\[int] Days remaining until the credits expire. formatint64 Link to this property eligible: Optional\[bool] Whether the account is eligible to receive credits. Link to this property has\_record: Optional\[bool] Whether a credit record exists for the account. Link to this property original\_amount\_cents: Optional\[int] The original credit amount in cents. formatint64 Link to this property percent\_consumed: Optional\[float] Percentage of the original credit amount consumed. formatdouble Link to this property projected\_depletion\_date: Optional\[datetime] Projected date when the credits will be depleted. formatdate-time Link to this property valid\_from: Optional\[datetime] When the credits become valid. formatdate-time Link to this property valid\_to: Optional\[datetime] When the credits expire. formatdate-time Link to this property
[Link to this property](<#(resource)%20billing.credits%20%3E%20(model)%20credit_get_response%20%3E%20(schema)>) ### Get Account Credits 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 ) credit = client.billing.credits.get( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(credit.valid_from) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "confirmed_balance_cents": 5000, "currency": "USD", "days_remaining": 180, "eligible": true, "has_record": true, "original_amount_cents": 10000, "percent_consumed": 50, "projected_depletion_date": "2024-07-01T00:00:00Z", "valid_from": "2024-01-01T00:00:00Z", "valid_to": "2025-01-01T00:00:00Z" }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "confirmed_balance_cents": 5000, "currency": "USD", "days_remaining": 180, "eligible": true, "has_record": true, "original_amount_cents": 10000, "percent_consumed": 50, "projected_depletion_date": "2024-07-01T00:00:00Z", "valid_from": "2024-01-01T00:00:00Z", "valid_to": "2025-01-01T00:00:00Z" }, "success": true } ```