--- title: Subscriptions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Zones](https://developers.cloudflare.com/api/python/resources/zones) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Subscriptions ##### [Zone Subscription Details](https://developers.cloudflare.com/api/python/resources/zones/subresources/subscriptions/methods/get) zones.subscriptions.get(SubscriptionGetParams\*\*kwargs) -> [SubscriptionGetResponse]() GET/zones/{zone\_id}/subscription ##### [Create Zone Subscription](https://developers.cloudflare.com/api/python/resources/zones/subresources/subscriptions/methods/create) zones.subscriptions.create(SubscriptionCreateParams\*\*kwargs) -> [SubscriptionCreateResponse]() POST/zones/{zone\_id}/subscription ##### [Update Zone Subscription](https://developers.cloudflare.com/api/python/resources/zones/subresources/subscriptions/methods/update) zones.subscriptions.update(SubscriptionUpdateParams\*\*kwargs) -> [SubscriptionUpdateResponse]() PUT/zones/{zone\_id}/subscription ##### ModelsExpand Collapse
class SubscriptionGetResponse: … id: Optional\[str] Subscription identifier tag. maxLength32 Link to this property currency: Optional\[str] The monetary unit in which pricing information is displayed. Link to this property current\_period\_end: Optional\[datetime] The end of the current period and also when the next billing is due. formatdate-time Link to this property current\_period\_start: Optional\[datetime] When the current billing period started. May match initial\_period\_start if this is the first period. formatdate-time Link to this property
frequency: Optional\[Literal\["weekly", "monthly", "quarterly", 2 more]] How often the subscription is renewed automatically. One of the following: "weekly" Link to this property "monthly" Link to this property "quarterly" Link to this property "yearly" Link to this property "not-applicable" Link to this property
Link to this property price: Optional\[float] The price of the subscription that will be billed, in US dollars. Link to this property rate\_plan: Optional\[RatePlan] The rate plan applied to the subscription. Link to this property
state: Optional\[Literal\["Trial", "Provisioned", "Paid", 4 more]] The state that the subscription is in. One of the following: "Trial" Link to this property "Provisioned" Link to this property "Paid" Link to this property "AwaitingPayment" Link to this property "Cancelled" Link to this property "Failed" Link to this property "Expired" Link to this property
Link to this property
[Link to this property](<#(resource)%20zones.subscriptions%20%3E%20(model)%20subscription_get_response%20%3E%20(schema)>)
class SubscriptionCreateResponse: … id: Optional\[str] Subscription identifier tag. maxLength32 Link to this property currency: Optional\[str] The monetary unit in which pricing information is displayed. Link to this property current\_period\_end: Optional\[datetime] The end of the current period and also when the next billing is due. formatdate-time Link to this property current\_period\_start: Optional\[datetime] When the current billing period started. May match initial\_period\_start if this is the first period. formatdate-time Link to this property
frequency: Optional\[Literal\["weekly", "monthly", "quarterly", 2 more]] How often the subscription is renewed automatically. One of the following: "weekly" Link to this property "monthly" Link to this property "quarterly" Link to this property "yearly" Link to this property "not-applicable" Link to this property
Link to this property price: Optional\[float] The price of the subscription that will be billed, in US dollars. Link to this property rate\_plan: Optional\[RatePlan] The rate plan applied to the subscription. Link to this property
state: Optional\[Literal\["Trial", "Provisioned", "Paid", 4 more]] The state that the subscription is in. One of the following: "Trial" Link to this property "Provisioned" Link to this property "Paid" Link to this property "AwaitingPayment" Link to this property "Cancelled" Link to this property "Failed" Link to this property "Expired" Link to this property
Link to this property
[Link to this property](<#(resource)%20zones.subscriptions%20%3E%20(model)%20subscription_create_response%20%3E%20(schema)>)
class SubscriptionUpdateResponse: … id: Optional\[str] Subscription identifier tag. maxLength32 Link to this property currency: Optional\[str] The monetary unit in which pricing information is displayed. Link to this property current\_period\_end: Optional\[datetime] The end of the current period and also when the next billing is due. formatdate-time Link to this property current\_period\_start: Optional\[datetime] When the current billing period started. May match initial\_period\_start if this is the first period. formatdate-time Link to this property
frequency: Optional\[Literal\["weekly", "monthly", "quarterly", 2 more]] How often the subscription is renewed automatically. One of the following: "weekly" Link to this property "monthly" Link to this property "quarterly" Link to this property "yearly" Link to this property "not-applicable" Link to this property
Link to this property price: Optional\[float] The price of the subscription that will be billed, in US dollars. Link to this property rate\_plan: Optional\[RatePlan] The rate plan applied to the subscription. Link to this property
state: Optional\[Literal\["Trial", "Provisioned", "Paid", 4 more]] The state that the subscription is in. One of the following: "Trial" Link to this property "Provisioned" Link to this property "Paid" Link to this property "AwaitingPayment" Link to this property "Cancelled" Link to this property "Failed" Link to this property "Expired" Link to this property
Link to this property
[Link to this property](<#(resource)%20zones.subscriptions%20%3E%20(model)%20subscription_update_response%20%3E%20(schema)>)