---
title: "List Transfers"
method: GET
path: "/core/v1/transfers"
tags: ["Transfers"]
---

# List Transfers

`GET /core/v1/transfers`

Returns all domain transfer requests for the account, including in-progress and recent transfers.

## Query parameters

- `perPage` integer — Maximum number of records to return per page for paginated list endpoints.
- `page` integer

## Response `200`

A successful response.

- ListTransfersResponse — ListTransfersResponse returns the list of pending transfers as well as the pagination information if relevant.
  - `lastPage` integer — LastPage is the identifier for the final page of results. It is only populated if there is another page of results after the current page.
  - `nextPage` integer — NextPage is the identifier for the next page of results. It is only populated if there is another page of results after the current page.
  - `totalCount` integer, required — TotalCount is total number of results.
  - `from` integer, required — From specifies starting record number on current page.
  - `to` integer, required — To specifies ending record number on current page.
  - `transfers` Transfer[], required — Transfers is a list of pending transfers
    - `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` — Bad request - Invalid query parameters.
- `401` — Unauthorized.
- `402` — Payment has failed for this transaction.
- `403` — Forbidden - you do not have permission to perform this action.
- `405` — Method not allowed.
- `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)