--- title: List account shares --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Resource Sharing](https://developers.cloudflare.com/api/python/resources/resource_sharing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List account shares resource\_sharing.list(ResourceSharingListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[ResourceSharingListResponse]()] GET/accounts/{account\_id}/shares Lists all account shares. ##### Security 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` ##### ParametersExpand Collapse account\_id: str Account identifier. maxLength32 [Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)

direction: Optional\[Literal\["asc", "desc"]] Direction to sort objects.

One of the following: "asc" Link to this property "desc" Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>) include\_recipient\_counts: Optional\[[bool]()] Include recipient counts in the response. [Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20include_recipient_counts%20%3E%20(schema)>) include\_resources: Optional\[[bool]()] Include resources in the response. [Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20include_resources%20%3E%20(schema)>)

kind: Optional\[Literal\["sent", "received"]] Filter shares by kind.

One of the following: "sent" Link to this property "received" Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20kind%20%3E%20(schema)>)

order: Optional\[Literal\["name", "created"]] Order shares by values in the given field.

One of the following: "name" Link to this property "created" Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order%20%3E%20(schema)>) page: Optional\[int] Page number. Defaults to `1` when `per_page` is supplied without `page`. May be omitted entirely along with `per_page` to receive a non-paginated response. minimum1 multipleOf1 [Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[int] Number of objects to return per page. Defaults to `20` when `page` is supplied without `per_page`. May be omitted entirely along with `page` to receive a non-paginated response. maximum100 minimum1 multipleOf1 [Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)

resource\_types: Optional\[List\[Literal\["custom-ruleset", "gateway-policy", "gateway-destination-ip", 4 more]]] Filter share resources by resource\_types.

One of the following: "custom-ruleset" Link to this property "gateway-policy" Link to this property "gateway-destination-ip" Link to this property "gateway-block-page-settings" Link to this property "gateway-extended-email-matching" Link to this property "idp-federation-grant" Link to this property "trust-grant" Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20resource_types%20%3E%20(schema)>)

status: Optional\[Literal\["active", "deleting", "deleted"]] Filter shares by status.

One of the following: "active" Link to this property "deleting" Link to this property "deleted" Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>) tag: Optional\[Sequence\[str]] Filter shares by tag. Each value is either `key=value` (matches shares whose tags contain that key/value pair) or `key` alone (matches shares that have any value for that key). May be repeated; multiple `tag` parameters are ANDed together. Maximum 20 `tag` parameters per request. [Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20tag%20%3E%20(schema)>)

target\_type: Optional\[Literal\["account", "organization"]] Filter shares by target\_type.

One of the following: "account" Link to this property "organization" Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20target_type%20%3E%20(schema)>) ##### ReturnsExpand Collapse

class ResourceSharingListResponse: …

id: str Share identifier tag. maxLength32 Link to this property account\_id: str Account identifier. maxLength32 Link to this property account\_name: str The display name of an account. Link to this property created: datetime When the share was created. formatdate-time Link to this property modified: datetime When the share was modified. formatdate-time Link to this property name: str The name of the share. Link to this property organization\_id: str Organization identifier. maxLength32 Link to this property

status: Literal\["active", "deleting", "deleted"]

One of the following: "active" Link to this property "deleting" Link to this property "deleted" Link to this property

Link to this property

target\_type: Literal\["account", "organization"]

One of the following: "account" Link to this property "organization" Link to this property

Link to this property associated\_recipient\_count: Optional\[int] The number of recipients in the ‘associated’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property associating\_recipient\_count: Optional\[int] The number of recipients in the ‘associating’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property disassociated\_recipient\_count: Optional\[int] The number of recipients in the ‘disassociated’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property disassociating\_recipient\_count: Optional\[int] The number of recipients in the ‘disassociating’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property

kind: Optional\[Literal\["sent", "received"]]

One of the following: "sent" Link to this property "received" Link to this property

Link to this property

resources: Optional\[List\[Resource]] A list of resources that are part of the share. This field is only included when requested via the ‘include\_resources’ parameter.

id: str Share Resource identifier. maxLength32 Link to this property created: datetime When the share was created. formatdate-time Link to this property meta: object Resource Metadata. Link to this property modified: datetime When the share was modified. formatdate-time Link to this property resource\_account\_id: str Account identifier. maxLength32 Link to this property resource\_id: str Share Resource identifier. maxLength32 Link to this property

resource\_type: Literal\["custom-ruleset", "gateway-policy", "gateway-destination-ip", 4 more] Resource Type.

Link to this property resource\_version: int Resource Version. Link to this property

status: Literal\["active", "deleting", "deleted"] Resource Status.

One of the following: "active" Link to this property "deleting" Link to this property "deleted" Link to this property

Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(model)%20resource_sharing_list_response%20%3E%20(schema)>) ### List account shares Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_email=os.environ.get("CLOUDFLARE_EMAIL"), # This is the default and can be omitted api_key=os.environ.get("CLOUDFLARE_API_KEY"), # This is the default and can be omitted ) page = client.resource_sharing.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "id": "3fd85f74b32742f1bff64a85009dda07", "account_id": "023e105f4ecef8ad9ca31a8372d0c353", "account_name": "Account A", "created": "2023-09-21T18:56:32.624632Z", "modified": "2023-09-21T18:56:32.624632Z", "name": "My Shared WAF Managed Rule", "organization_id": "023e105f4ecef8ad9ca31a8372d0c353", "status": "active", "target_type": "account", "associated_recipient_count": 10, "associating_recipient_count": 1, "disassociated_recipient_count": 0, "disassociating_recipient_count": 0, "kind": "sent", "resources": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "created": "2023-09-21T18:56:32.624632Z", "meta": {}, "modified": "2023-09-21T18:56:32.624632Z", "resource_account_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_type": "custom-ruleset", "resource_version": 0, "status": "active" } ] } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 50 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "id": "3fd85f74b32742f1bff64a85009dda07", "account_id": "023e105f4ecef8ad9ca31a8372d0c353", "account_name": "Account A", "created": "2023-09-21T18:56:32.624632Z", "modified": "2023-09-21T18:56:32.624632Z", "name": "My Shared WAF Managed Rule", "organization_id": "023e105f4ecef8ad9ca31a8372d0c353", "status": "active", "target_type": "account", "associated_recipient_count": 10, "associating_recipient_count": 1, "disassociated_recipient_count": 0, "disassociating_recipient_count": 0, "kind": "sent", "resources": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "created": "2023-09-21T18:56:32.624632Z", "meta": {}, "modified": "2023-09-21T18:56:32.624632Z", "resource_account_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_type": "custom-ruleset", "resource_version": 0, "status": "active" } ] } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 50 } } ```