---
title: "POST /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/initiateTransfer"
method: POST
path: "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/initiateTransfer"
tags: ["Transfers"]
---

# POST /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/initiateTransfer

`POST /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/initiateTransfer`

Sends a request to a user in a customer's billing account to transfer billing ownership of their subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.

## Path parameters

- `billingAccountName` string, required
- `billingProfileName` string, required
- `customerName` string, required

## Request body

- InitiateTransferRequest — Request parameters to initiate transfer.
  - `properties` InitiateTransferProperties — Request parameters to initiate transfer.
    - `recipientEmailId` string — The email ID of the recipient to whom the transfer request is sent.
    - `resellerId` string — Optional MPN ID of the reseller for transfer requests that are sent from a Microsoft Partner Agreement billing account.

## Response `200`

Initiated transfer details.

- TransferDetails — Details of the transfer.
  - `properties` TransferProperties — Transfer details
    - `creationTime` string, date-time — The time at which the transfer request was created.
    - `expirationTime` string, date-time — The time at which the transfer request expires.
    - `invoiceSectionId` string — The ID of the invoice section to which the product is billed after the transfer request is completed.
    - `billingAccountId` string — The ID of the billing account to which the product is billed after the transfer request is completed.
    - `resellerId` string — Optional MPN ID of the reseller for transfer requests that are sent from a Microsoft Partner Agreement billing account.
    - `resellerName` string — Optional name of the reseller for transfer requests that are sent from Microsoft Partner Agreement billing account.
    - `initiatorCustomerType` string — The type of customer who sent the transfer request.
    - `billingProfileId` string — The ID of the billing profile to which the product will be billed after the transfer.
    - `transferStatus` 'Pending' | 'InProgress' | 'Completed' | 'CompletedWithErrors' | 'Failed' | 'Canceled' | 'Declined' — The status of a transfer.
    - `recipientEmailId` string — The email ID of the user to whom the transfer request was sent.
    - `initiatorEmailId` string — The email ID of the user who sent the transfer request.
    - `canceledBy` string — The email ID of the user who canceled the transfer request.
    - `lastModifiedTime` string, date-time — The time at which the transfer request was last modified.
    - `detailedTransferStatus` DetailedTransferStatus[] — Detailed transfer status.
      - `productType` 'AzureSubscription' | 'AzureReservation' — The type of product that is transferred.
      - `productId` string — The ID of the product that is transferred.
      - `transferStatus` 'NotStarted' | 'InProgress' | 'Completed' | 'Failed' — The status of a transfer.
      - `errorDetails` Error — Error details for transfer execution.
        - `errorCode` string — Error code.
        - `errorMessage` string — Error message.

## Other responses

- `default` — Unexpected error.

---

[API](https://skmtc.net/azure/apis/billingmanagementclient.md) · [All operations](https://skmtc.net/azure/apis/billingmanagementclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/billingmanagementclient/revisions/481e7355ac16/schema)