# Business entity transfers

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


`business_entity_transfer` encapsulates the details of the movement of a resource (such as `[customer](/docs/api/customers)` and `[subscription](/docs/api/subscriptions)` ) from one `[business_entity](/docs/api/business_entities)` to another.

**Related Endpoints**

-   [Transfer resource to another business entity](/docs/api/business_entities/transfer-resources-to-another-business-entity)
-   [List business entity transfers](/docs/api/business_entities/list-the-business-entity-transfers)

## Sample Business entity transfer

```json
{
  "id": "__dev__263BEVU6h5FkGm",
  "resource_type": "customer",
  "reason_code": "correction",
  "created_at": 1710140499,
  "object": "business_entity_transfer",
  "destination_business_entity_id": "2",
  "source_business_entity_id": "1",
  "resource_id": "__dev__263BEVU6h5FlTn",
  "active_resource_id": "__dev__263BEVU6h5DnYj"
}
```

## Business entity transfers attributes

## Input Parameters

- `id` (required, string, max chars=50)
  Unique identifier of the `business_entity_transfer`. Chargebee automatically generates this.

- `resource_type` (required, enumerated string)
  The type of the resource that was transferred.
  Possible enum values:
    - `customer`
      Represents the transfer of a `[customer](/docs/api/customers)` resource.
    - `subscription`
      Represents the transfer of a `[subscriptions](/docs/api/subscriptions)` resource linked to a `[customer](/docs/api/customers)` resource.

- `resource_id` (required, string, max chars=50)
  The `id` of the deprecated version of the resource. This is the resource linked to the source `[business_entity](/docs/api/business_entities)` .

- `active_resource_id` (required, string, max chars=50)
  The `id` of the active version of the resource. This is the resource linked to the destination `[business_entity](/docs/api/business_entities)` .

- `destination_business_entity_id` (required, string, max chars=50)
  The unique identifier of the `[business_entity](/docs/api/business_entities)` to which the resource has been transferred.

- `source_business_entity_id` (required, string, max chars=50)
  The unique identifier of the `[business_entity](/docs/api/business_entities)` from which the resource has been transferred.

- `reason_code` (required, enumerated string)
  The reason for transferring the resource to another business entity.
  Possible enum values:
    - `correction`
      Correction of a wrongly assigned business entity.

- `created_at` (required, timestamp(UTC) in seconds)
  Timestamp indicating when this business entity transfer record was created.

