---
updatedAt: 2025-11-11T21:43:25.000Z
agentTools:
  projectIndex: https://domains.opensrs.guide/llms.txt
---

# check_transfer

Checks to see if the specified domain can be transferred in to OpenSRS, or from one OpenSRS reseller to another. This call can also be used to check the status of the last transfer request on a given domain name.

When you use the **check_transfer** action prior to initiating a transfer, the **transferable** response parameter is most relevant, and if **transferable = 0**, the reason field is also important.

When you use the **check_transfer** action to determine the progress of a transfer, the **status** parameter is most important. If the response indicates that the transfer is in progress and the status is **pending_registry**, the transfer will be scheduled to complete within 5 minutes of the query; running the query expedites the process and causes the transfer to complete within 5 minutes.

## Request parameters for check\_transfer

## Standard parameters

* **action** = check\_transfer
* **object** = domain

## Attributes

Parameters within the **attributes** associative array are described below.

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parameter name
      </th>

      <th>
        Obligation
      </th>

      <th>
        Definition/Value
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        check\_status
      </td>

      <td>
        Optional
      </td>

      <td>
        Flag to request the status of a transfer request. If the transfer state is returned as **pending\_registry** and the Registry shows OpenSRS as the Registrar of record, OpenSRS schedules the completion of gTLD transfers.

        Allowed values are **0** or **1**.
      </td>
    </tr>

    <tr>
      <td>
        domain
      </td>

      <td>
        Required
      </td>

      <td>
        The fully qualified domain name in the transfer order.
      </td>
    </tr>

    <tr>
      <td>
        get\_request\_address
      </td>

      <td>
        Optional
      </td>

      <td>
        Flag to request the registrant's contact email address. This is useful if you want to make\
        sure that your client can receive mail at that address to acknowledge the transfer.

        Allowed values are **0** or **1**.
      </td>
    </tr>
  </tbody>
</Table>

## Response parameters for check\_transfer

## Standard parameters

* **action** = reply
* **object** = domain
* **is\_success** = a Boolean is returned, indicating success or failure of the request
* **response\_code** = response code indicating outcome of the request
* **response\_text** = message describing the outcome of the request

## Attributes

If the request is successful, the **attributes** associative array may include the following:

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parameter name
      </th>

      <th>
        Obligation
      </th>

      <th>
        Definition/Value
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        noservice
      </td>

      <td>
        Returned if\
        **is\_success=true**
      </td>

      <td>
        Indication of supplier availability:

        * **0**—Supplier is available

        * **1**—Supplier is unavailable. 

        Note: When **noservice** is **1** then transferable is set to **0** and **is\_success** is set to **1**.
      </td>
    </tr>

    <tr>
      <td>
        reason
      </td>

      <td>
        Returned if **is\_success** = true and **transferrable = 0**
      </td>

      <td>
        Reason for transfer status.
      </td>
    </tr>

    <tr>
      <td>
        request\_address
      </td>

      <td>
        Optional
      </td>

      <td>
        Valid email address of registrant, which can be used to make sure that they can receive mail at that address to acknowledge the transfer.
      </td>
    </tr>

    <tr>
      <td>
        status
      </td>

      <td>
        Returned if **is\_success** = true. If no transfer is underway, this value is retrieved from the previous transfer order.
      </td>

      <td>
        Status of the latest transfer on the domain initiated by the reseller.

        * \*Note\*\*: Resellers can only request status for transfers that they initiated (any checks for transfers initiated by other resellers returns 'undef').

          * **pending\_owner**—Awaiting approval by domain's admin contact (every transfer begins with this status). If approval is not given within five days, the transfer is cancelled by OpenSRS.

          * **pending\_admin**—Waiting for approval by OpenSRS support staff.

          * **pending\_registry**—Awaiting registry approval (the transfer completes after 7 days unless it is declined by the current registrar). If the Registry shows OpenSRS as the Registrar of record, OpenSRS schedules the completion of gTLD transfers. The transfer will be scheduled to complete within 5 minutes of the query.

          * **completed**—The transfer completed successfully.

          * **cancelled**—The reseller or OpenSRS stopped the transfer.

          * **undef**—No transfer exists for this domain.
      </td>
    </tr>

    <tr>
      <td>
        timestamp
      </td>

      <td>
        Returned if **is\_success = true**. If no transfer is currently underway, timestamp is retrieved from the previous transfer order.
      </td>

      <td>
        The date and time of the most recent update to the state of the transfer (which could be placement of an order, an owner request, an owner confirmation, a registry request, or completion/cancellation of an order).

        Date format is DD MMM YYYY 00:00:00 GMT
      </td>
    </tr>

    <tr>
      <td>
        transferrable
      </td>

      <td>
        Included only when a transfer request has not been submitted for the specified domain
      </td>

      <td>
        Whether the domain can be transferred. 

        * **0**—Cannot be transferred

        * **1**—Can be transferred
      </td>
    </tr>

    <tr>
      <td>
        type
      </td>

      <td>
        Returned if **is\_success** = true and **transferrable = 1**
      </td>

      <td>
        Type of transfer initiated:

        * **reg2reg**—Transfer from one registrar to another.

        * **rsp2rsp**—Transfer between two resellers of the same registrar.
      </td>
    </tr>

    <tr>
      <td>
        unixtime
      </td>

      <td>
        Returned if **is\_success = true**. If no transfer is currently underway, unixtime is retrieved from the previous transfer order.
      </td>

      <td>
        Conversion of timestamp, in seconds since Epoch (1 Jan 1970 00:00:00 GMT).
      </td>
    </tr>
  </tbody>
</Table>

## Examples for check\_transfer

**Request and Response**

This request may have one of three possible responses.

**Response 1**

Indicates that the transfer is awaiting approval by domain's admin contact .

**Response 2**

Indicates that the transfer was successful. The status shows pending\_registry because a cronjob needs to run to complete the transfer process; however, running the check transfer command causes the transfer to complete within 5 minutes.

**Response 3**

This response indicates that the transfer request completed and the domain is now with OpenSRS.

```xml Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key="protocol">XCP</item>
                <item key="action">CHECK_TRANSFER</item>
                <item key="object">DOMAIN</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="domain">example.com</item>
                        <item key="check_status">1</item>
                        <item key="get_request_address">1</item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>
```
```xml Response 1
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE OPS_envelope>
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key=""protocol"">XCP</item>
                <item key=""object"">DOMAIN</item>
                <item key=""response_text"">Query successful</item>
                <item key=""action"">REPLY</item>
                <item key=""attributes"">
                    <dt_assoc>
                        <item key=""transferrable"">0</item>
                        <item key=""noservice"">0</item>
                        <item key=""status"">pending_owner</item>
                        <item key=""reason"">Transfer in progress</item>
                        <item key=""unixtime"">1520826472</item>
                        <item key=""request_address"">user@domain.com</item>
                        <item key=""timestamp"">Mon Jun 18 15:15:25 2012</item>
                    </dt_assoc>
                </item>
                <item key=""response_code"">200</item>
                <item key=""is_success"">1</item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>
```
```xml Response 2
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key="protocol">XCP</item>
                <item key="action">REPLY</item>
                <item key="object">DOMAIN</item>
                <item key="is_success">1</item>
                <item key="response_code">200</item>
                <item key="response_text">Query successful. Transfer scheduled in 5 minutes.</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="transferrable">0</item>
                        <item key="noservice">0</item>
                        <item key="timestamp">Thu Jun 14 11:05:34 2012</item>
                        <item key="status">pending_registry</item>
                        <item key="reason">Transfer in progress</item>
                        <item key="unixtime">1339686334</item>
                        <item key="request_address">requester@example.com</item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>
```
```xml Response 3
<?xml version='1.0' encoding="UTF-8" standalone="no"?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key="protocol">XCP</item>
                <item key="object">DOMAIN</item>
                <item key="is_success">1</item>
                <item key="response_text">Query successful</item>
                <item key="action">REPLY</item>
                <item key="response_code">200</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="transferrable">0</item>
                        <item key="reason_code">domain_already_belongs_to_current_reseller</item>
                        <item key="noservice">0</item>
                        <item key="timestamp">Mon Jun 18 15:15:25 2012</item>
                        <item key="status">completed</item>
                        <item key="reason">Domain already exists in RESELLER_NAME's account</item>
                        <item key="unixtime">1340046925</item>
                        <item key="request_address">requester@example.com</item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>
```