get (userinfo)

Retrieves a user's general information.

Request parameters for get (userinfo)

Standard parameters

  • action = get
  • object = user_info

Attributes

Parameters within the attributes associative array are described below.

Parameter nameObligationDefinition/Value
domainRequiredThe relevant domain.

Response parameters for get (userinfo)

Standard parameters

  • action = reply
  • object = userinfo
  • 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

The Reseller Agent (RSA) could respond with a 250 response_code, which indicates that the action was submitted for processing in an asynchronous registry. OpenSRS processes the request when the registry's reply is received.

Performing a get userinfo command indicates if there is an action currently waiting on a domain. This information can be used to alert the user that there is a waiting request.

Attributes

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

Parameter nameObligationDefinition/Value
capabilitiesReturned if is_success = trueAn associative array containing parameters specific to the action.
dns_errorsReturned for .DE if is_success = trueThis contains the DNS errors if any, in text format .DE only
domainReturned if is_success = trueFully qualified domain name. IDN names are returned in Punycode for .COM/.NET and in RACE for .ORG.
domain_countReturned if is_success = trueTotal number of domains in the current user profile. A domain count > 1 indicates that the get domain list action is possible.
encoding_typeOptionalEncoding type for the domain. For a list of languages and codes, see
Appendix C: Encoding Types for IDNs”.
expiredateReturned if is_success= trueExpiration date for the domain as specified in the 'domain' field.
f_ownerReturned if is_success= trueA flag indicating whether the current user is the owner of the domain(s).

If set to 1 then the current user is the owner of the domain, if set to 0, then the user is a subuser of the domain and may only be authorized to do certain actions.
permissionReturned if is_success = trueAn associative array containing parameters specific to the action.

1—Owner
2—Admin
4—Billing
8—Tech
16—Nameservers
32—Rsp_whois_info
usernameReturned if is_success = trueThe sub-user's username
waiting_requests_noReturned if is_success = trueThe number of registry requests in the waiting state.

Capabilities

Parameters within the capabilities associative array are described below.

Parameter nameObligationDefinition/Value
change_ips_tagOptionalIndicates if option is available for end user to change the Domain Tag; applicable to .UK domains only.

1—Option available for end user to change Domain Tag

0—Option not available for end user to change Domain Tag
domain_auth_infoAlways returnedSecret pass phrase stored at the registry, which is used to authorize transfers of domains.

1—True

0—False

The absence of a key also signifies false.
dnssecAlways returnedIndicates whether DNSSEC is supported for domain.

1—True

0—False
forwarding_emailAlways returnedSome TLDs offer an email forwarding service. Often the end user must explicitly purchase this service.

1—True

0—False

The absence of a key also signifies false.
uk_whois_optOptionalIndicates if option is available for end user to opt out of display of personal information in WHOIS for .UK. The WHOIS opt-out is available for .UK domains only, and only to individuals (i.e. not corporations).

1—End user is eligible to use the opt-out feature for .UK WHOIS

0—End user is not eligible to use the opt- out feature for .UK WHOIS

Examples for get (userinfo)

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">GET</item>
                <item key="object">USERINFO</item>
                <item key="domain">yourdomain.com</item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>

Response

<?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">USERINFO</item>
                <item key="is_success">1</item>
                <item key="response_code">200</item>
                <item key="response_text">Command Successful</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="waiting_requests_no">8</item>
                        <item key="domain">example.org.uk</item>
                        <item key="encoding_type" />
                        <item key="expiredate">2007-11-25 00:00:00</item>
                        <item key="permission" />
                        <item key="domain_count">131</item>
                        <item key="f_owner">1</item>
                        <item key="username">aaaa</item>
                        <item key="capabilities">
                            <dt_assoc>
                                <item key="forwarding_email">0</item>
                                <item key="domain_auth_info">0</item>
                                <item key="dnssec">1</item>
                                <item key="uk_whois_opt">1</item>
                                <item key="change_ips_tag">1</item>
                            </dt_assoc>
                        </item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>