Get Account Entitlements

accounts.entitlements.list() -> 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

ReturnsExpand Collapse

class EntitlementListResponse: …

A single entitlement record for a zone or account.

id: str

Entitlement identifier — equal to the feature key.

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"

"max_count"

"enum_number"

"range"

"string"

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

int

str

List[float]

class AllocationValueUnionMember4: …

max: int

min: int

created_date: str

ISO 8601 timestamp (microsecond precision, no timezone offset) when the entitlement was created. Format: YYYY-MM-DDTHH:MM:SS.ffffff.

deleted_date: str

ISO 8601 timestamp when the entitlement was deleted, or empty string if not deleted.

edited_date: str

ISO 8601 timestamp (microsecond precision, no timezone offset) when the entitlement was last edited.

feature: Feature

Describes a product feature associated with an entitlement.

id: int

Numeric identifier of the feature.

formatint64

feature_set: str

The logical grouping (set) this feature belongs to.

key: str

Unique string key for the feature.

name: str

Human-readable name of the feature.

Get Account Entitlements

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)

{
  "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

{
  "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
}