--- title: List account shares --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Resource Sharing](https://developers.cloudflare.com/api/go/resources/resource_sharing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List account shares client.ResourceSharing.List(ctx, params) (\*V4PagePaginationArray\[[ResourceSharingListResponse]()], error) 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
params ResourceSharingListParams AccountID param.Field\[string] Path param: Account identifier. maxLength32 Link to this property
Direction param.Field\[ResourceSharingListParamsDirection]Optional Query param: Direction to sort objects. const ResourceSharingListParamsDirectionAsc ResourceSharingListParamsDirection = "asc" Link to this property const ResourceSharingListParamsDirectionDesc ResourceSharingListParamsDirection = "desc" Link to this property
Link to this property IncludeRecipientCounts param.Field\[bool]Optional Query param: Include recipient counts in the response. Link to this property IncludeResources param.Field\[bool]Optional Query param: Include resources in the response. Link to this property
Kind param.Field\[ResourceSharingListParamsKind]Optional Query param: Filter shares by kind. const ResourceSharingListParamsKindSent ResourceSharingListParamsKind = "sent" Link to this property const ResourceSharingListParamsKindReceived ResourceSharingListParamsKind = "received" Link to this property
Link to this property
Order param.Field\[ResourceSharingListParamsOrder]Optional Query param: Order shares by values in the given field. const ResourceSharingListParamsOrderName ResourceSharingListParamsOrder = "name" Link to this property const ResourceSharingListParamsOrderCreated ResourceSharingListParamsOrder = "created" Link to this property
Link to this property Page param.Field\[int64]Optional Query param: 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 PerPage param.Field\[int64]Optional Query param: 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
ResourceTypes param.Field\[\[]ResourceSharingListParamsResourceType]Optional Query param: Filter share resources by resource\_types. const ResourceSharingListParamsResourceTypeCustomRuleset ResourceSharingListParamsResourceType = "custom-ruleset" Link to this property const ResourceSharingListParamsResourceTypeGatewayPolicy ResourceSharingListParamsResourceType = "gateway-policy" Link to this property const ResourceSharingListParamsResourceTypeGatewayDestinationIP ResourceSharingListParamsResourceType = "gateway-destination-ip" Link to this property const ResourceSharingListParamsResourceTypeGatewayBlockPageSettings ResourceSharingListParamsResourceType = "gateway-block-page-settings" Link to this property const ResourceSharingListParamsResourceTypeGatewayExtendedEmailMatching ResourceSharingListParamsResourceType = "gateway-extended-email-matching" Link to this property const ResourceSharingListParamsResourceTypeIdPFederationGrant ResourceSharingListParamsResourceType = "idp-federation-grant" Link to this property const ResourceSharingListParamsResourceTypeTrustGrant ResourceSharingListParamsResourceType = "trust-grant" Link to this property
Link to this property
Status param.Field\[ResourceSharingListParamsStatus]Optional Query param: Filter shares by status. const ResourceSharingListParamsStatusActive ResourceSharingListParamsStatus = "active" Link to this property const ResourceSharingListParamsStatusDeleting ResourceSharingListParamsStatus = "deleting" Link to this property const ResourceSharingListParamsStatusDeleted ResourceSharingListParamsStatus = "deleted" Link to this property
Link to this property Tag param.Field\[\[]string]Optional Query param: 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
TargetType param.Field\[ResourceSharingListParamsTargetType]Optional Query param: Filter shares by target\_type. const ResourceSharingListParamsTargetTypeAccount ResourceSharingListParamsTargetType = "account" Link to this property const ResourceSharingListParamsTargetTypeOrganization ResourceSharingListParamsTargetType = "organization" Link to this property
Link to this property
[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type ResourceSharingListResponse struct{…} ID string Share identifier tag. maxLength32 Link to this property AccountID string Account identifier. maxLength32 Link to this property AccountName string The display name of an account. Link to this property Created Time When the share was created. formatdate-time Link to this property Modified Time When the share was modified. formatdate-time Link to this property Name string The name of the share. Link to this property OrganizationID string Organization identifier. maxLength32 Link to this property
Status ResourceSharingListResponseStatus One of the following: const ResourceSharingListResponseStatusActive ResourceSharingListResponseStatus = "active" Link to this property const ResourceSharingListResponseStatusDeleting ResourceSharingListResponseStatus = "deleting" Link to this property const ResourceSharingListResponseStatusDeleted ResourceSharingListResponseStatus = "deleted" Link to this property
Link to this property
TargetType ResourceSharingListResponseTargetType One of the following: const ResourceSharingListResponseTargetTypeAccount ResourceSharingListResponseTargetType = "account" Link to this property const ResourceSharingListResponseTargetTypeOrganization ResourceSharingListResponseTargetType = "organization" Link to this property
Link to this property AssociatedRecipientCount int64Optional 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 AssociatingRecipientCount int64Optional 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 DisassociatedRecipientCount int64Optional 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 DisassociatingRecipientCount int64Optional 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 ResourceSharingListResponseKindOptional One of the following: const ResourceSharingListResponseKindSent ResourceSharingListResponseKind = "sent" Link to this property const ResourceSharingListResponseKindReceived ResourceSharingListResponseKind = "received" Link to this property
Link to this property
Resources \[]ResourceSharingListResponseResourceOptional A list of resources that are part of the share. This field is only included when requested via the ‘include\_resources’ parameter. ID string Share Resource identifier. maxLength32 Link to this property Created Time When the share was created. formatdate-time Link to this property Meta unknown Resource Metadata. Link to this property Modified Time When the share was modified. formatdate-time Link to this property ResourceAccountID string Account identifier. maxLength32 Link to this property ResourceID string Share Resource identifier. maxLength32 Link to this property
ResourceType ResourceSharingListResponseResourcesResourceType Resource Type. One of the following: const ResourceSharingListResponseResourcesResourceTypeCustomRuleset ResourceSharingListResponseResourcesResourceType = "custom-ruleset" Link to this property const ResourceSharingListResponseResourcesResourceTypeGatewayPolicy ResourceSharingListResponseResourcesResourceType = "gateway-policy" Link to this property const ResourceSharingListResponseResourcesResourceTypeGatewayDestinationIP ResourceSharingListResponseResourcesResourceType = "gateway-destination-ip" Link to this property const ResourceSharingListResponseResourcesResourceTypeGatewayBlockPageSettings ResourceSharingListResponseResourcesResourceType = "gateway-block-page-settings" Link to this property const ResourceSharingListResponseResourcesResourceTypeGatewayExtendedEmailMatching ResourceSharingListResponseResourcesResourceType = "gateway-extended-email-matching" Link to this property const ResourceSharingListResponseResourcesResourceTypeIdPFederationGrant ResourceSharingListResponseResourcesResourceType = "idp-federation-grant" Link to this property const ResourceSharingListResponseResourcesResourceTypeTrustGrant ResourceSharingListResponseResourcesResourceType = "trust-grant" Link to this property
Link to this property ResourceVersion int64 Resource Version. Link to this property
Status ResourceSharingListResponseResourcesStatus Resource Status. One of the following: const ResourceSharingListResponseResourcesStatusActive ResourceSharingListResponseResourcesStatus = "active" Link to this property const ResourceSharingListResponseResourcesStatusDeleting ResourceSharingListResponseResourcesStatus = "deleting" Link to this property const ResourceSharingListResponseResourcesStatusDeleted ResourceSharingListResponseResourcesStatus = "deleted" Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20resource_sharing%20%3E%20(model)%20ResourceSharingListResponse%20%3E%20(schema)>) ### List account shares Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/resource_sharing" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) page, err := client.ResourceSharing.List(context.TODO(), resource_sharing.ResourceSharingListParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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 } } ```