---
title: "Cancel Transfer"
method: POST
path: "/core/v1/transfers/{domainName}:cancel"
tags: ["Transfers"]
---

# Cancel Transfer

`POST /core/v1/transfers/{domainName}:cancel`

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.

Cancelable statuses:
- pending
- submitting_transfer
- pending_new_auth_code
- pending_unlock
- pending_registry_unlock
- rejected

Non-cancelable statuses:
- pending_transfer
- pending_insert
- completed
- failed
- canceled
- canceled_pending_refund

## Path parameters

- `domainName` string, required

## Response `200`

A successful response.

- Transfer — Transfer contains all relevant data for a domain transfer to name.com.
  - `domainName` string, required — DomainName is the domain to be transfered to name.com.
  - `email` string, email — 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.
  - `status` 'canceled' | 'canceled_pending_refund' | 'completed' | 'failed' | 'pending' | 'pending_insert' | 'pending_new_auth_code' | 'pending_registry_unlock' | 'pending_transfer' | 'pending_unlock' | 'rejected' | 'submitting_transfer', required — Terminal (finished; will not change): - **completed**: Completed. - **failed**: Failed. - **canceled**: Canceled by the user. - **canceled_pending_refund**: Canceled; refund processing. Non-terminal (in progress; may change): - **pending**: Requested. - **submitting_transfer**: Being submitted to the registry. - **pending_new_auth_code**: New auth code required. - **pending_unlock**: Waiting for losing registrar unlock. - **pending_registry_unlock**: Waiting for registry unlock. - **pending_transfer**: Pending at the registry. - **pending_insert**: Transfer complete; domain will be added to the account. - **rejected**: Rejected at the losing registrar.

## Other responses

- `400` — Response returned when you have requested to cancel a transfer that has already been cancelled.
- `401` — Unauthorized.
- `403` — Forbidden - you do not have permission to perform this action.
- `404` — We were unable to locate a cancelable transfer for the requested domain.
- `405` — Method not allowed.
- `409` — Response returned when the transfer cannot be canceled due to its current processing state.
- `415` — All POST, PUT, PATCH requests for this API must include the `Content-Type: application/json` header in the requests.
- `429` — Rate limit has been exceeded.
- `500` — Internal server error.
- `502` — Bad Gateway
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/name/apis/name-com-core-api.md) · [All operations](https://skmtc.dev/name/apis/name-com-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/name/name-com-core-api/revisions/a37d4cbd3991/schema)