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 name

Parameter name

Definition/Value

affect_domains

Optional

Flag 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_set

Required

Contains new contact information for each specified contact type. For more information, see ContactSet.

domain

Required

The domain to be updated.

report_email

Optional

The 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'

types

Required

The 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 name

Obligation

Definition/Valu

details

Returned if is_success = true

A 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_type

Optional

The encoding type for this domain. For a list of languages and codes, see Appendix C: Encoding Types for
IDNs
.

response_code

Returned if
is_success = true

The response code associated with the modification on this domain.

response_text

Returned if
is_success = true

The response text associated with the modification on this domain.

waiting_requests_no

Returned 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>