--- title: Get Account Entitlements --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Accounts](https://developers.cloudflare.com/api/python/resources/accounts) [Entitlements](https://developers.cloudflare.com/api/python/resources/accounts/subresources/entitlements) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Account Entitlements accounts.entitlements.list(EntitlementListParams\*\*kwargs) -> SyncSinglePage\[[EntitlementListResponse]()] GET/accounts/{account\_id}/entitlements Returns the list of entitlements (features and their allocations) for a given account. Each entitlement describes a product feature the account is permitted to use and the allocation value (boolean, count, range, enum, or string) that governs its behaviour. ##### 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) `Account Read` ##### ParametersExpand Collapse account\_id: str Identifier tag. maxLength32 minLength32 [Link to this property](<#(resource)%20accounts.entitlements%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class EntitlementListResponse: … A single entitlement record for a zone or account. id: str Entitlement identifier — equal to the feature key. Link to this property
allocation: Allocation Represents the allocation value for an entitlement. The shape of value depends on type: bool uses a boolean, max_count uses an integer, enum_number uses an array of numbers, range uses an object with min and max integer fields, and string uses a string.
type: Literal\["bool", "max\_count", "enum\_number", 2 more] Allocation type discriminator. One of the following: "bool" Link to this property "max\_count" Link to this property "enum\_number" Link to this property "range" Link to this property "string" Link to this property
Link to this property
value: AllocationValue Contains the allocation value whose concrete type the type field determines: bool yields a boolean, max\_count yields an integer, enum\_number yields an array of numbers, range yields an object with min and max, and string yields a string. One of the following: bool Link to this property int Link to this property str Link to this property List\[float] Link to this property
class AllocationValueUnionMember4: … max: int Link to this property min: int Link to this property
Link to this property
Link to this property
Link to this property created\_date: str ISO 8601 timestamp (microsecond precision, no timezone offset) when the entitlement was created. Format: YYYY-MM-DDTHH:MM:SS.ffffff. Link to this property deleted\_date: str ISO 8601 timestamp when the entitlement was deleted, or empty string if not deleted. Link to this property edited\_date: str ISO 8601 timestamp (microsecond precision, no timezone offset) when the entitlement was last edited. Link to this property
feature: Feature Describes a product feature associated with an entitlement. id: int Numeric identifier of the feature. formatint64 Link to this property feature\_set: str The logical grouping (set) this feature belongs to. Link to this property key: str Unique string key for the feature. Link to this property name: str Human-readable name of the feature. Link to this property
Link to this property
[Link to this property](<#(resource)%20accounts.entitlements%20%3E%20(model)%20entitlement_list_response%20%3E%20(schema)>) ### Get Account Entitlements 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.accounts.entitlements.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.id) ``` 200 example ``` { "errors": [], "messages": [], "result": [ { "allocation": { "type": "string", "value": "default" }, "created_date": "2024-01-01T00:00:00.000000", "deleted_date": "", "edited_date": "2024-01-01T00:00:01.000000", "feature": { "feature_set": "deployment", "id": 99, "key": "deployment.cohort", "name": "Deployment Cohort" }, "id": "deployment.cohort" }, { "allocation": { "type": "range", "value": { "max": 86400, "min": 10 } }, "created_date": "2021-09-17T21:02:02.000000", "deleted_date": "", "edited_date": "2021-09-17T21:02:10.000000", "feature": { "feature_set": "rate_limiting", "id": 33, "key": "rate_limiting.timeout_bounds", "name": "rate_limiting.timeout_bounds" }, "id": "rate_limiting.timeout_bounds" } ], "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [], "messages": [], "result": [ { "allocation": { "type": "string", "value": "default" }, "created_date": "2024-01-01T00:00:00.000000", "deleted_date": "", "edited_date": "2024-01-01T00:00:01.000000", "feature": { "feature_set": "deployment", "id": 99, "key": "deployment.cohort", "name": "Deployment Cohort" }, "id": "deployment.cohort" }, { "allocation": { "type": "range", "value": { "max": 86400, "min": 10 } }, "created_date": "2021-09-17T21:02:02.000000", "deleted_date": "", "edited_date": "2021-09-17T21:02:10.000000", "feature": { "feature_set": "rate_limiting", "id": 33, "key": "rate_limiting.timeout_bounds", "name": "rate_limiting.timeout_bounds" }, "id": "rate_limiting.timeout_bounds" } ], "success": true } ```