--- title: Get share recipient by ID --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Resource Sharing](https://developers.cloudflare.com/api/python/resources/resource_sharing) [Recipients](https://developers.cloudflare.com/api/python/resources/resource_sharing/subresources/recipients) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get share recipient by ID resource\_sharing.recipients.get(strrecipient\_id, RecipientGetParams\*\*kwargs) -> [RecipientGetResponse]() GET/accounts/{account\_id}/shares/{share\_id}/recipients/{recipient\_id} Get share recipient by ID. ##### 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.recipients%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) share\_id: str Share identifier tag. maxLength32 [Link to this property](<#(resource)%20resource_sharing.recipients%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20share_id%20%3E%20(schema)>) recipient\_id: str Share Recipient identifier tag. maxLength32 [Link to this property](<#(resource)%20resource_sharing.recipients%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20recipient_id%20%3E%20(schema)>) include\_resources: Optional\[[bool]()] Include resources in the response. [Link to this property](<#(resource)%20resource_sharing.recipients%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20include_resources%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class RecipientGetResponse: … A recipient of a share. The association_status field tracks the lifecycle of the shared resources in the recipient account. All recipients are returned by the list endpoint regardless of status; filter client-side if only active recipients are needed. id: str Share Recipient identifier tag. maxLength32 Link to this property account\_id: str Account identifier. maxLength32 Link to this property
association\_status: Literal\["associating", "associated", "disassociating", "disassociated"] The current state of the recipient relative to the share. The desired_association_status (not exposed in the response) tracks the target state set by the API; the background reconciliation workflow drives current_association_status toward it. - associating — The recipient was recently added; the workflow is pushing shared resources into the recipient account. - associated — Shared resources have been successfully applied to the recipient account. - disassociating — The recipient was removed (via DELETE or PUT replacement); the workflow is removing shared resources from the recipient account. - disassociated — Shared resources have been removed from the recipient account. The recipient record remains in the database. One of the following: "associating" Link to this property "associated" Link to this property "disassociating" Link to this property "disassociated" Link to this property
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
resources: Optional\[List\[Resource]] error: str Share Recipient error message. Link to this property resource\_id: str Share Resource identifier. maxLength32 Link to this property resource\_version: int Resource Version. Link to this property terminal: bool Whether the error is terminal or will be continually retried. Link to this property
Link to this property
[Link to this property](<#(resource)%20resource_sharing.recipients%20%3E%20(model)%20recipient_get_response%20%3E%20(schema)>) ### Get share recipient by ID 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 ) recipient = client.resource_sharing.recipients.get( recipient_id="3fd85f74b32742f1bff64a85009dda07", account_id="023e105f4ecef8ad9ca31a8372d0c353", share_id="3fd85f74b32742f1bff64a85009dda07", ) print(recipient.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "3fd85f74b32742f1bff64a85009dda07", "account_id": "023e105f4ecef8ad9ca31a8372d0c353", "association_status": "associating", "created": "2023-09-21T18:56:32.624632Z", "modified": "2023-09-21T18:56:32.624632Z", "resources": [ { "error": "Recipient is missing necessary entitlement", "resource_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_version": 0, "terminal": true } ] } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "3fd85f74b32742f1bff64a85009dda07", "account_id": "023e105f4ecef8ad9ca31a8372d0c353", "association_status": "associating", "created": "2023-09-21T18:56:32.624632Z", "modified": "2023-09-21T18:56:32.624632Z", "resources": [ { "error": "Recipient is missing necessary entitlement", "resource_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_version": 0, "terminal": true } ] } } ```