Title: contact-ext EPP extension
Status: draft
Version: 1.0
Release date: 2026.06.01
Owner: KazNIC Organization

1. Introduction

The KazNIC registry allows registrars to specify values for an extended list of contact attributes using the 
extension described below.

The extension allows for specifying additional residence details attributes.

2. EPP <greeting> Server Response

Response frames for <greeting> server response returned to a client by the KazNIC EPP server contains 
definition of the server supported extension "Contact Extension" in the <contact-ext> element.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" 
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
    <greeting>
        <svID>KazNIC Registry EPP server</svID>
        <svDate>2011-01-05T07:44:50.014Z</svDate>
        <svcMenu>
            <version>1.0</version>
            <lang>en</lang>
            <objURI>urn:ietf:params:xml:ns:domain-1.0</objURI>
            <objURI>urn:ietf:params:xml:ns:contact-1.0</objURI>
            <objURI>urn:ietf:params:xml:ns:host-1.0</objURI>
            <svcExtension>
                .......
		<extURI>urn:kaznic:params:xml:ns:contact-ext-1.0</extURI>
                <extURI>http://nic.kz/contact-ext-1.0</extURI>
            </svcExtension>
        </svcMenu>
    </greeting>
</epp>


3. EPP <create> Command

Request frames for <create> commands for contact object sent to an EPP server that supports this extension MAY have an 
additional <contact-ext:create> element in the <extension> element. The <contact-ext:create> element MAY contain a 
<contact-ext:residenceDetails> element containing additional residence details attributes.

The <contact-ext:residenceDetails> MUST contain "country" attribute which contains country-code for residence, 
MUST contain <contact-ext:externalIdType> and <contact-ext:externalIdValue> elements containing a ID type value and ID value. 

Example <create> request frame with a <contact-ext:create> element:


<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
    <command>
        <create>
            <contact:create
                xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
                xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 contact-1.0.xsd">
                <contact:id>sh8013</contact:id>
                <contact:postalInfo type="int">
                    <contact:name>John Doe</contact:name>
                    <contact:org>Example Inc.</contact:org>
                    <contact:addr>
                        <contact:street>123 Example Dr.</contact:street>
                        <contact:street>Suite 100</contact:street>
                        <contact:city>Dulles</contact:city>
                        <contact:sp>VA</contact:sp>
                        <contact:pc>20166-6503</contact:pc>
                        <contact:cc>US</contact:cc>
                    </contact:addr>
                </contact:postalInfo>
                <contact:voice x="1234">+1.7035555555</contact:voice>
                <contact:fax>+1.7035555556</contact:fax>
                <contact:email>jdoe@example.com</contact:email>
                <contact:authInfo>
                    <contact:pw>2fooBAR</contact:pw>
                </contact:authInfo>
                <contact:disclose flag="0">
                    <contact:voice/>
                    <contact:email/>
                </contact:disclose>
            </contact:create>
        </create>
        <extension>
            <contact-ext:create xmlns:contact-ext="urn:ietf:params:xml:ns:contact-ext-1.0">	                
                <contact-ext:residenceDetails country="KZ">                    
                    <contact-ext:externalIdType>BIN</contact-ext:externalIdType>                    
                    <contact-ext:externalIdValue>123-45-67890</contact-ext:externalIdValue>
                </contact-ext:residenceDetails>
            </contact-ext:create>
        </extension>
        <clTRID>ABC-12345</clTRID>
    </command>
</epp>

       
4. EPP <update> Command

Request frames for <update> commands for contact object sent to an EPP server that supports this extension MAY have an 
additional <contact-ext:update> element in the <extension> element. The <contact-ext:update> element MAY contain a 
<contact-ext:residenceDetails> element containing additional residence details attributes.

The <contact-ext:residenceDetails> MUST contain "country" attribute which contains country-code for residence, 
MUST contain <contact-ext:externalIdType> and <contact-ext:externalIdValue> elements containing a ID type value and ID value. 
    
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
    <command>
        <update>
            <contact:update
                xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
                xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 contact-1.0.xsd">
                <contact:id>sh8013</contact:id>
                <contact:add>
                    <contact:status s="clientDeleteProhibited"/>
                </contact:add>
                <contact:chg>
                    <contact:postalInfo type="int">
                        <contact:org/>
                        <contact:addr>
                            <contact:street>124 Example Dr.</contact:street>
                            <contact:street>Suite 200</contact:street>
                            <contact:city>Dulles</contact:city>
                            <contact:sp>VA</contact:sp>
                            <contact:pc>20166-6503</contact:pc>
                            <contact:cc>US</contact:cc>
                        </contact:addr>
                    </contact:postalInfo>
                    <contact:voice>+1.7034444444</contact:voice>
                    <contact:fax/>
                    <contact:authInfo>
                        <contact:pw>2fooBAR</contact:pw>
                    </contact:authInfo>
                    <contact:disclose flag="1">
                        <contact:voice/>
                        <contact:email/>
                    </contact:disclose>
                </contact:chg>
            </contact:update>
        </update>
        <extension>
            <contact-ext:update xmlns:contact-ext="urn:ietf:params:xml:ns:contact-ext-1.0">	
                <contact-ext:residenceDetails country="KZ">                    
                    <contact-ext:externalIdType>BIN</contact-ext:externalIdType>                    
                    <contact-ext:externalIdValue>123-45-67890</contact-ext:externalIdValue>
                </contact-ext:residenceDetails>
            </contact-ext:update>
        </extension>
        <clTRID>ABC-12345</clTRID>
    </command>
</epp>


5. EPP <info> Command

Response frames for <info> commands for contact object returned to a client by an EPP server that supports this 
extension MAY have an additional <contact-ext:infData> element in the <extension> element. The <contact-ext:infData> 
element MAY contain a <contact-ext:residenceDetails> element containing additional residence details attributes.

Example <info> response frame with a <kz-law-ext:infData> element:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
    <response>
        <result code="1000">
            <msg>Command completed successfully</msg>
        </result>
        <resData>
            <contact:infData
                xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
                xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 contact-1.0.xsd">
                <contact:id>sh8013</contact:id>
                <contact:roid>SH8013-REP</contact:roid>
                <contact:status s="linked"/>
                <contact:status s="clientDeleteProhibited"/>
                <contact:postalInfo type="int">
                    <contact:name>John Doe</contact:name>
                    <contact:org>Example Inc.</contact:org>
                    <contact:addr>
                        <contact:street>123 Example Dr.</contact:street>
                        <contact:street>Suite 100</contact:street>
                        <contact:city>Dulles</contact:city>
                        <contact:sp>VA</contact:sp>
                        <contact:pc>20166-6503</contact:pc>
                        <contact:cc>US</contact:cc>
                    </contact:addr>
                </contact:postalInfo>
                <contact:voice x="1234">+1.7035555555</contact:voice>
                <contact:fax>+1.7035555556</contact:fax>
                <contact:email>jdoe@example.com</contact:email>
                <contact:clID>ClientY</contact:clID>
                <contact:crID>ClientX</contact:crID>
                <contact:crDate>1999-04-03T22:00:00.0Z</contact:crDate>
                <contact:upID>ClientX</contact:upID>
                <contact:upDate>1999-12-03T09:00:00.0Z</contact:upDate>
                <contact:trDate>2000-04-08T09:00:00.0Z</contact:trDate>
                <contact:authInfo>
                    <contact:pw>2fooBAR</contact:pw>
                </contact:authInfo>
                <contact:disclose flag="0">
                    <contact:voice/>
                    <contact:email/>
                </contact:disclose>
            </contact:infData>
        </resData>
        <extension>
            <contact-ext:infData xmlns:contact-ext="urn:ietf:params:xml:ns:contact-ext-1.0">	
                <contact-ext:residenceDetails country="KZ">                    
                    <contact-ext:externalIdType>BIN</contact-ext:externalIdType>                    
                    <contact-ext:externalIdValue>123-45-67890</contact-ext:externalIdValue>
                </contact-ext:residenceDetails>
            </contact-ext:infData>
        </extension>
        <trID>
            <clTRID>ABC-12345</clTRID>
            <svTRID>54322-XYZ</svTRID>
        </trID>
    </response>
</epp>

6. Formal Specification

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns:contact-ext="urn:kaznic:params:xml:ns:contact-ext-1.0"
  xmlns="http://www.w3.org/2001/XMLSchema"
  targetNamespace="urn:kaznic:params:xml:ns:contact-ext-1.0" elementFormDefault="qualified">

  <annotation>
    	<documentation>
		Extensible Provisioning Protocol v1.0 contact object extension schema for "Contact Extension" 
		modification.
	</documentation>
  </annotation>

  <element name="create" type="contact-ext:contactExtData"/>
  <element name="update" type="contact-ext:contactExtData"/>
  <element name="infData" type="contact-ext:contactExtData"/>

  <complexType name="contactExtData">
    <sequence>
      <element name="residenceDetails" type="contact-ext:residenceDetailsData"/>
    </sequence>
  </complexType>

  <complexType name="residenceDetailsData">
    <sequence>
      <attribute name="country" type="contact-ext:country"/>
      <element name="externalIdType" type="contact-ext:externalIdType"/>
      <element name="externalIdValue" type="contact-ext:externalIdValue"/>
    </sequence>
  </complexType>

  <simpleType name="country">
     <restriction base="normalizedString">
	<pattern value="[A-Z]{2}"/>
     </restriction>
  </simpleType>

  <simpleType name="externalIdType">
     <restriction base="normalizedString">
       <pattern value="[A-Z]{1,20}"/>
     </restriction>
  </simpleType>

  <simpleType name="externalIdValue">
     <restriction base="normalizedString">
       <minLength value="1"/>
       <maxLength value="50"/>
     </restriction>
  </simpleType>

</schema>