---
title: "Declines a transfer request."
method: POST
path: "/providers/Microsoft.Billing/transfers/{transferName}/declineTransfer"
tags: ["RecipientTransfers"]
---

# Declines a transfer request.

`POST /providers/Microsoft.Billing/transfers/{transferName}/declineTransfer`

## Path parameters

- `transferName` string, required

## Response `200`

Details of the declined transfer.

- RecipientTransferDetails — Details of the transfer.
  - `properties` RecipientTransferProperties — 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.
    - `allowedProductType` EligibleProductType[] — Type of subscriptions that can be transferred.
    - `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.
    - `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.
    - `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)