update_contacts

Submits a domain-contact information update to the OpenSRS system. Each contact object is submitted as a whole to OpenSRS, and changes are parsed against the existing information.

📘

NOTE:

This command cannot be used for .DK TLDs.

For .UK domains, if you use this command to submit a change to the Organization field, it is recognized by OpenSRS, but not by the registry. To change the .UK Organization information, you must contact the Nominet Registry.

For .ES domains, if you use this command to submit any changes to the owner contact information, the changes are recognized by OpenSRS, but not by the registry. To change the .ES Owner contact information, you must contact the Esnic Registry.

For .IT domains, the owner contact requires three additional parameters: entity_type, nationality_code, and reg_code. For more information about contact_set values, see .IT contact requirements.

Request parameters for update_contacts

Standard parameters

  • action = update_contacts
  • object = domain

Attributes

Parameters within the attributes associative array are described below.

Parameter nameParameter nameDefinition/Value
affect_domainsOptionalFlag indicating the domains to which to apply the change.

0—Change applies only to the specified domain. This is the default.

1—Change applies to all domains linked to
this profile.
contact_setRequiredContains new contact information for each specified contact type. For more information, see ContactSet.
domainRequiredThe domain to be updated.
report_emailOptionalThe End User's email address to which notification of success or failure is sent. The notification email is sent on behalf of the reseller.

Note: This parameter can only be specified if affect_domains is set to '1'
typesRequiredThe contact types whose information is changing. Allowed values are; owner, admin, billing, and tech.

Response parameters for update_contacts

Standard parameters

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

Parameter nameObligationDefinition/Valu
detailsReturned if is_success = trueA description of the success or failure of each affected domain.

The key is the name of the domain.

When you specify a contact_info modification, you can specify that you want the action to apply to all domains.

Because the modification may succeed or fail on a case-by-case basis, you get a response code for each domain that is affected.

The key that is used to access this domain success information is the name of the domain itself, for example, 'mydomain.com' or 'mydomain.co.uk'.

Each key contains a hash (described below) that provides details on the action performed on that domain.
encoding_typeOptionalThe encoding type for this domain. For a list of languages and codes, see Appendix C: Encoding Types for
IDNs
.
response_codeReturned if
is_success = true
The response code associated with the modification on this domain.
response_textReturned if
is_success = true
The response text associated with the modification on this domain.
waiting_requests_noReturned if
is_success = true
The number of registry requests in the waiting state.

Examples for update_contacts

<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key="protocol">XCP</item>
                <item key="action">UPDATE_CONTACTS</item>
                <item key="object">DOMAIN</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="domain">example.com</item>
                        <item key="types">
                            <dt_array>
                                <item key="0">owner</item>
                                <item key="1">admin</item>
                                <item key="2">billing</item>
                                <item key="3">tech</item>
                            </dt_array>
                        </item>
                        <item key="contact_set">
                            <dt_assoc>
                                <item key="owner">
                                    <dt_assoc>
                                        <item key="country">US</item>
                                        <item key="org_name">Example Inc.</item>
                                        <item key="phone">+1.4165550123</item>
                                        <item key="last_name">Ottway</item>
                                        <item key="address2">Suite 500</item>
                                        <item key="state">CA</item>
                                        <item key="email">[email protected]</item>
                                        <item key="city">SomeCity</item>
                                        <item key="postal_code">90210</item>
                                        <item key="fax">+1.4165550124</item>
                                        <item key="address1">32 Oak Street</item>
                                        <item key="first_name">Owen</item>
                                        <item key="title">Organization</item>
                                    </dt_assoc>
                                </item>
                                <item key="admin">
                                    <dt_assoc>
                                        <item key="country">US</item>
                                        <item key="org_name">Example Inc.</item>
                                        <item key="phone">+1.4165550123</item>
                                        <item key="last_name">Adams</item>
                                        <item key="address2">Suite 100</item>
                                        <item key="state">CA</item>
                                        <item key="email">[email protected]</item>
                                        <item key="city">Santa Clara</item>
                                        <item key="postal_code">90210</item>
                                        <item key="fax">+1.4165550125</item>
                                        <item key="address1">32 Oak Street</item>
                                        <item key="first_name">Adler</item>
                                        <item key="title">Admin</item>
                                    </dt_assoc>
                                </item>
                                <item key="billing">
                                    <dt_assoc>
                                        <item key="country">US</item>
                                        <item key="org_name">Example Inc.</item>
                                        <item key="phone">+1.4165550123</item>
                                        <item key="last_name">Burton</item>
                                        <item key="address2">Suite 200</item>
                                        <item key="state">CA</item>
                                        <item key="email">[email protected]</item>
                                        <item key="city">Santa Clara</item>
                                        <item key="postal_code">90210</item>
                                        <item key="fax">+1.4165550136</item>
                                        <item key="address1">32 Oak Street</item>
                                        <item key="first_name">Bill</item>
                                        <item key="title">Billing</item>
                                    </dt_assoc>
                                </item>
                                <item key="tech">
                                    <dt_assoc>
                                        <item key="country">US</item>
                                        <item key="org_name">Example Inc.</item>
                                        <item key="phone">+1.4165550123</item>
                                        <item key="last_name">Wayne</item>
                                        <item key="address2">Suite 200</item>
                                        <item key="state">CA</item>
                                        <item key="email">[email protected]</item>
                                        <item key="city">Santa Clara</item>
                                        <item key="postal_code">90210</item>
                                        <item key="fax">+1.4165550136</item>
                                        <item key="address1">32 Oak Street</item>
                                        <item key="first_name">Thomas</item>
                                        <item key="title">Tech</item>
                                    </dt_assoc>
                                </item>
                            </dt_assoc>
                        </item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key="protocol">XCP</item>
                <item key="action">UPDATE_CONTACTS</item>
                <item key="object">DOMAIN</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="domain">example.com</item>
                        <item key="types">
                            <dt_array>
                                <item key="0">owner</item>
                                <item key="1">admin</item>
                                <item key="2">billing</item>
                                <item key="3">tech</item>
                            </dt_array>
                        </item>
                        <item key="contact_set">
                            <dt_assoc>
                                <item key="owner">
                                    <dt_assoc>
                                        <item key="country">US</item>
                                        <item key="org_name">Example Inc.</item>
                                        <item key="phone">+1.4165550123</item>
                                        <item key="last_name">Ottway</item>
                                        <item key="address2">Suite 500</item>
                                        <item key="state">CA</item>
                                        <item key="email">[email protected]</item>
                                        <item key="city">SomeCity</item>
                                        <item key="postal_code">90210</item>
                                        <item key="fax">+1.4165550124</item>
                                        <item key="address1">32 Oak Street</item>
                                        <item key="first_name">Owen</item>
                                        <item key="title">Owner</item>
                                    </dt_assoc>
                                </item>
                                <item key="admin">
                                    <dt_assoc>
                                        <item key="country">US</item>
                                        <item key="org_name">Example Inc.</item>
                                        <item key="phone">+1.4165550123</item>
                                        <item key="last_name">Adams</item>
                                        <item key="address2">Suite 100</item>
                                        <item key="state">CA</item>
                                        <item key="email">[email protected]</item>
                                        <item key="city">Santa Clara</item>
                                        <item key="postal_code">90210</item>
                                        <item key="fax">+1.4165550125</item>
                                        <item key="address1">32 Oak Street</item>
                                        <item key="first_name">Adler</item>
                                        <item key="title">Admin</item>
                                    </dt_assoc>
                                </item>
                                <item key="billing">
                                    <dt_assoc>
                                        <item key="country">US</item>
                                        <item key="org_name">Example Inc.</item>
                                        <item key="phone">+1.4165550123</item>
                                        <item key="last_name">Burton</item>
                                        <item key="address2">Suite 200</item>
                                        <item key="state">CA</item>
                                        <item key="email">[email protected]</item>
                                        <item key="city">Santa Clara</item>
                                        <item key="postal_code">90210</item>
                                        <item key="fax">+1.4165550136</item>
                                        <item key="address1">32 Oak Street</item>
                                        <item key="first_name">Bill</item>
                                        <item key="title">Billing</item>
                                    </dt_assoc>
                                </item>
                                <item key="tech">
                                    <dt_assoc>
                                        <item key="country">US</item>
                                        <item key="org_name">Example Inc.</item>
                                        <item key="phone">+1.4165550123</item>
                                        <item key="last_name">Wayne</item>
                                        <item key="address2">Suite 200</item>
                                        <item key="state">CA</item>
                                        <item key="email">[email protected]</item>
                                        <item key="city">Santa Clara</item>
                                        <item key="postal_code">90210</item>
                                        <item key="fax">+1.4165550136</item>
                                        <item key="address1">32 Oak Street</item>
                                        <item key="first_name">Thomas</item>
                                        <item key="title">Tech</item>
                                    </dt_assoc>
                                </item>
                            </dt_assoc>
                        </item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>