--- title: Subscriptions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Zones](https://developers.cloudflare.com/api/typescript/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/typescript/resources/zones/subresources/subscriptions/methods/get) client.zones.subscriptions.get(SubscriptionGetParams {zone\_id } params, RequestOptionsoptions?): [SubscriptionGetResponse]() {id, currency, current\_period\_end, 5 more } GET/zones/{zone\_id}/subscription ##### [Create Zone Subscription](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/subscriptions/methods/create) client.zones.subscriptions.create(SubscriptionCreateParams {zone\_id, frequency, rate\_plan } params, RequestOptionsoptions?): [SubscriptionCreateResponse]() {id, currency, current\_period\_end, 5 more } POST/zones/{zone\_id}/subscription ##### [Update Zone Subscription](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/subscriptions/methods/update) client.zones.subscriptions.update(SubscriptionUpdateParams {zone\_id, frequency, rate\_plan } params, RequestOptionsoptions?): [SubscriptionUpdateResponse]() {id, currency, current\_period\_end, 5 more } PUT/zones/{zone\_id}/subscription ##### ModelsExpand Collapse
SubscriptionGetResponse {id, currency, current\_period\_end, 5 more } id?: string Subscription identifier tag. maxLength32 Link to this property currency?: string The monetary unit in which pricing information is displayed. Link to this property current\_period\_end?: string The end of the current period and also when the next billing is due. formatdate-time Link to this property current\_period\_start?: string When the current billing period started. May match initial\_period\_start if this is the first period. formatdate-time Link to this property
frequency?: "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?: number The price of the subscription that will be billed, in US dollars. Link to this property rate\_plan?: RatePlan {id, currency, externally\_managed, 4 more } The rate plan applied to the subscription. Link to this property
state?: "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)>)
SubscriptionCreateResponse {id, currency, current\_period\_end, 5 more } id?: string Subscription identifier tag. maxLength32 Link to this property currency?: string The monetary unit in which pricing information is displayed. Link to this property current\_period\_end?: string The end of the current period and also when the next billing is due. formatdate-time Link to this property current\_period\_start?: string When the current billing period started. May match initial\_period\_start if this is the first period. formatdate-time Link to this property
frequency?: "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?: number The price of the subscription that will be billed, in US dollars. Link to this property rate\_plan?: RatePlan {id, currency, externally\_managed, 4 more } The rate plan applied to the subscription. Link to this property
state?: "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)>)
SubscriptionUpdateResponse {id, currency, current\_period\_end, 5 more } id?: string Subscription identifier tag. maxLength32 Link to this property currency?: string The monetary unit in which pricing information is displayed. Link to this property current\_period\_end?: string The end of the current period and also when the next billing is due. formatdate-time Link to this property current\_period\_start?: string When the current billing period started. May match initial\_period\_start if this is the first period. formatdate-time Link to this property
frequency?: "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?: number The price of the subscription that will be billed, in US dollars. Link to this property rate\_plan?: RatePlan {id, currency, externally\_managed, 4 more } The rate plan applied to the subscription. Link to this property
state?: "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)>)