--- title: List Available Plans --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Zones](https://developers.cloudflare.com/api/python/resources/zones) [Plans](https://developers.cloudflare.com/api/python/resources/zones/subresources/plans) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Available Plans zones.plans.list(PlanListParams\*\*kwargs) -> SyncSinglePage\[[AvailableRatePlan]()] GET/zones/{zone\_id}/available\_plans Lists available plans the zone can subscribe to. ##### 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 zone\_id: str Identifier maxLength32 [Link to this property](<#(resource)%20zones.plans%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class AvailableRatePlan: … id: Optional\[str] Identifier maxLength32 Link to this property can\_subscribe: Optional\[bool] Indicates whether you can subscribe to this plan. Link to this property currency: Optional\[str] The monetary unit in which pricing information is displayed. Link to this property externally\_managed: Optional\[bool] Indicates whether this plan is managed externally. Link to this property
frequency: Optional\[Literal\["weekly", "monthly", "quarterly", "yearly"]] The frequency at which you will be billed for this plan. One of the following: "weekly" Link to this property "monthly" Link to this property "quarterly" Link to this property "yearly" Link to this property
Link to this property is\_subscribed: Optional\[bool] Indicates whether you are currently subscribed to this plan. Link to this property legacy\_id: Optional\[str] The legacy identifier for this rate plan, if any. Link to this property name: Optional\[str] The plan name. maxLength80 Link to this property price: Optional\[float] The amount you will be billed for this plan. Link to this property
[Link to this property](<#(resource)%20zones.plans%20%3E%20(model)%20available_rate_plan%20%3E%20(schema)>) ### List Available Plans 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 ) page = client.zones.plans.list( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.id) ``` 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": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "can_subscribe": true, "currency": "USD", "externally_managed": false, "frequency": "monthly", "is_subscribed": false, "legacy_id": "free", "name": "Free Plan", "price": 0 } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ``` ##### 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": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "can_subscribe": true, "currency": "USD", "externally_managed": false, "frequency": "monthly", "is_subscribed": false, "legacy_id": "free", "name": "Free Plan", "price": 0 } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```