# List Transfers

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

Endpoint: GET /core/v1/transfers
Version: 1.3.1
Security: BasicAuth

## Query parameters:

  - `perPage` (integer)
    Per Page is the number of records to return per request. Per Page defaults to 1,000.

  - `page` (integer)
    Page is which page to return.

## Response 200 fields (application/json):

  - `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` (array, required)
    Transfers is a list of pending transfers

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

  - `transfers.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"

  - `transfers.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 401 fields (application/json):

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

## Response 402 fields (application/json):

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

  - `details` (string,null)
    Additional context or information about the error
    Example: "Insufficient Funds"

## 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."