# Cancel Transfer

Cancels a pending transfer request. This can be used if the transfer was initiated in error or if the authorization code provided was incorrect. The price of the transfer will refund the amount to account credit.

Endpoint: POST /core/v1/transfers/{domainName}:cancel
Version: 1.3.1
Security: BasicAuth

## Path parameters:

  - `domainName` (string, required)
    DomainName is the domain to cancel the transfer for.

## Response 200 fields (application/json):

  - `domainName` (string, required)
    DomainName is the domain to be transfered to name.com.
    Example: "example.com"

  - `email` (string)
    Email is the email address that the approval email was sent to. Not every TLD requries an approval email. This is usually pulled from Whois.
    Example: "admin@example.com"

  - `status` (string, required)
    The current status of the transfer. Details about statuses can be found in the following Knowledge Base article: .
    Example: "pending_transfer"

## Response 400 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error.
    Example: "Internal Server Error"

  - `details` (string,null)
    Additional context or information about the error.
    Example: "Something went wrong."

## Response 404 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Not Found"

  - `details` (string,null)
    Additional context or information about the error
    Example: "The requested domain does not exist."

## Response 415 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "The 'Content-Type' header must be 'application/json' for this request."

## Response 429 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Rate Limit Exceeded"

## Response 500 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error.
    Example: "Internal Server Error"

  - `details` (string,null)
    Additional context or information about the error.
    Example: "Something went wrong."