---
title: Billing
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/python)

[User](https://developers.cloudflare.com/api/python/resources/user)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Billing

#### BillingHistory

##### [Billing History Details](https://developers.cloudflare.com/api/python/resources/user/subresources/billing/subresources/history/methods/list)

Deprecated

user.billing.history.list(HistoryListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[BillingHistory](<https://developers.cloudflare.com/api/python/resources/user#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)>)]

GET/user/billing/history

##### ModelsExpand Collapse

<details>

<summary>

class BillingHistory: …

</summary>

id: str

Billing item identifier tag.

maxLength32

<a href="#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

action: str

The billing item action.

maxLength30

<a href="#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)%20%3E%20(property)%20action">Link to this property</a>

amount: float

The amount associated with this billing item.

<a href="#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)%20%3E%20(property)%20amount">Link to this property</a>

currency: str

The monetary unit in which pricing information is displayed.

<a href="#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)%20%3E%20(property)%20currency">Link to this property</a>

description: str

The billing item description.

maxLength255

<a href="#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

occurred\_at: datetime

When the billing item was created.

formatdate-time

<a href="#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)%20%3E%20(property)%20occurred_at">Link to this property</a>

type: str

The billing item type.

maxLength30

<a href="#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)%20%3E%20(property)%20type">Link to this property</a>

<details>

<summary>

zone: Zone

</summary>

name: Optional\[str]

<a href="#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)%20%3E%20(property)%20zone%20%3E%20(property)%20name">Link to this property</a>

</details>

<a href="#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)%20%3E%20(property)%20zone">Link to this property</a>

</details>

[Link to this property](<#(resource)%20user.billing.history%20%3E%20(model)%20billing_history%20%3E%20(schema)>)

#### BillingProfile

##### [Billing Profile Details](https://developers.cloudflare.com/api/python/resources/user/subresources/billing/subresources/profile/methods/get)

Deprecated

user.billing.profile.get() -> [ProfileGetResponse](<https://developers.cloudflare.com/api/python/resources/user#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)>)

GET/user/billing/profile

##### ModelsExpand Collapse

<details>

<summary>

class ProfileGetResponse: …

</summary>

id: Optional\[str]

Billing item identifier tag.

maxLength32

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

account\_type: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20account_type">Link to this property</a>

address: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20address">Link to this property</a>

address2: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20address2">Link to this property</a>

balance: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20balance">Link to this property</a>

card\_expiry\_month: Optional\[int]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20card_expiry_month">Link to this property</a>

card\_expiry\_year: Optional\[int]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20card_expiry_year">Link to this property</a>

card\_number: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20card_number">Link to this property</a>

city: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20city">Link to this property</a>

company: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20company">Link to this property</a>

country: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20country">Link to this property</a>

created\_on: Optional\[datetime]

formatdate-time

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20created_on">Link to this property</a>

device\_data: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20device_data">Link to this property</a>

edited\_on: Optional\[datetime]

formatdate-time

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20edited_on">Link to this property</a>

enterprise\_billing\_email: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20enterprise_billing_email">Link to this property</a>

enterprise\_primary\_email: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20enterprise_primary_email">Link to this property</a>

first\_name: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20first_name">Link to this property</a>

is\_partner: Optional\[bool]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20is_partner">Link to this property</a>

last\_name: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20last_name">Link to this property</a>

next\_bill\_date: Optional\[datetime]

formatdate-time

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20next_bill_date">Link to this property</a>

payment\_address: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_address">Link to this property</a>

payment\_address2: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_address2">Link to this property</a>

payment\_city: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_city">Link to this property</a>

payment\_country: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_country">Link to this property</a>

payment\_email: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_email">Link to this property</a>

payment\_first\_name: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_first_name">Link to this property</a>

payment\_gateway: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_gateway">Link to this property</a>

payment\_last\_name: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_last_name">Link to this property</a>

payment\_nonce: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_nonce">Link to this property</a>

payment\_state: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_state">Link to this property</a>

payment\_zipcode: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20payment_zipcode">Link to this property</a>

primary\_email: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20primary_email">Link to this property</a>

state: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20state">Link to this property</a>

tax\_id\_type: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20tax_id_type">Link to this property</a>

telephone: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20telephone">Link to this property</a>

validation\_code: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20validation_code">Link to this property</a>

vat: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20vat">Link to this property</a>

zipcode: Optional\[str]

<a href="#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)%20%3E%20(property)%20zipcode">Link to this property</a>

</details>

[Link to this property](<#(resource)%20user.billing.profile%20%3E%20(model)%20profile_get_response%20%3E%20(schema)>)