Unregistry Documentation

Complete guide to the multi-domain registry platform

Latest Update: Version 2.0 includes EPP gateway support, enhanced API features, and improved bulk operations.

Platform Overview

Unregistry is an enterprise-grade subdomain registry platform that provides comprehensive domain management services across multiple premium TLD extensions. Our platform offers both REST API and EPP gateway access for maximum flexibility and compatibility with existing domain management systems.

🌐

Multi-Domain Support

Manage subdomains across multiple premium TLD extensions from a single platform.

🔌

Dual Protocol Access

Choose between modern REST API or industry-standard EPP protocol.

🚀

High Performance

99.9% uptime SLA with global anycast DNS network.

🔒

Enterprise Security

SOC 2 compliant with multi-factor authentication and audit logging.

EPP Gateway

ENTERPRISE

Extensible Provisioning Protocol (EPP)

The Unregistry EPP Gateway provides industry-standard RFC 5730-5734 compliant access to our registry system. EPP is the preferred protocol for high-volume registrars and enterprise clients who require direct registry integration.

Connection Details

Host: epp.unregistry.com
Port: 700 (EPP Standard)
Protocol: TCP with TLS 1.3
Authentication: X.509 Client Certificate + Password
Supported Extensions:
  - secDNS (RFC 5910)
  - rgp (RFC 3915)
  - launch (RFC 8334)
  - fee (RFC 8748)

EPP Session Lifecycle

  1. TLS Handshake
    Establish secure connection using client certificate
  2. Greeting Exchange
    Server sends greeting with supported features
  3. Login Command
    Authenticate with credentials and select services
  4. Domain Operations
    Execute check, create, info, update, renew, transfer, delete
  5. Logout & Disconnect
    Gracefully close session

EPP Command Examples

Login Command

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <command>
    <login>
      <clID>ClientX</clID>
      <pw>foo-BAR2</pw>
      <options>
        <version>1.0</version>
        <lang>en</lang>
      </options>
      <svcs>
        <objURI>urn:ietf:params:xml:ns:domain-1.0</objURI>
        <objURI>urn:ietf:params:xml:ns:contact-1.0</objURI>
        <svcExtension>
          <extURI>urn:ietf:params:xml:ns:secDNS-1.1</extURI>
        </svcExtension>
      </svcs>
    </login>
    <clTRID>ABC-12345</clTRID>
  </command>
</epp>

Domain Check

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <command>
    <check>
      <domain:check xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
        <domain:name>shop.com.store</domain:name>
        <domain:name>api.com.store</domain:name>
        <domain:name>portal.com.store</domain:name>
      </domain:check>
    </check>
    <clTRID>ABC-12346</clTRID>
  </command>
</epp>

Domain Create

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <command>
    <create>
      <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
        <domain:name>shop.com.store</domain:name>
        <domain:period unit="y">2</domain:period>
        <domain:ns>
          <domain:hostObj>ns1.unregistry.com</domain:hostObj>
          <domain:hostObj>ns2.unregistry.com</domain:hostObj>
        </domain:ns>
        <domain:registrant>jd1234</domain:registrant>
        <domain:contact type="admin">sh8013</domain:contact>
        <domain:contact type="tech">sh8013</domain:contact>
        <domain:authInfo>
          <domain:pw>2fooBAR</domain:pw>
        </domain:authInfo>
      </domain:create>
    </create>
    <clTRID>ABC-12347</clTRID>
  </command>
</epp>

EPP Response Codes

Code Result Description
1000 Success Command completed successfully
1001 Success Command completed successfully; action pending
1300 Success Command completed successfully; no messages
1301 Success Command completed successfully; ack to dequeue
1500 Success Command completed successfully; ending session
2001 Error Unknown command
2002 Error Command use error
2003 Error Required parameter missing
2004 Error Parameter value range error
2005 Error Parameter value syntax error
2201 Error Authorization error
2302 Error Object exists
2303 Error Object does not exist

Quick Start Guide

Ready in 5 minutes! Follow these steps to register your first subdomain.
  1. Create Your Account
    Register at portal.unregistry.com with your email and organization details
  2. Get Your API Key
    Navigate to Settings → API Keys and generate your first key
  3. Check Availability
    curl -X GET https://com.store/api/v2/subdomains/shop \
      -H "X-API-Key: your_api_key"
  4. Register Subdomain
    curl -X POST https://com.store/api/v2/subdomains \
      -H "X-API-Key: your_api_key" \
      -H "Content-Type: application/json" \
      -d '{"subdomain": "shop", "domain": "com.store"}'
  5. Configure DNS
    Add DNS records through the API or web portal

Supported Domain Extensions

Unregistry supports multiple premium TLD extensions, each optimized for specific business verticals and use cases.

Category Extensions Use Cases Features
E-Commerce Premium retail TLDs Online stores, marketplaces SSL included, CDN optimization
Enterprise Professional TLDs Corporate services, B2B Priority support, SLA
Media Creative TLDs Content platforms, streaming High bandwidth, media CDN
Supply Chain Industry TLDs B2B marketplaces, logistics API priority, bulk operations

Domain Lifecycle

Every subdomain follows a standard lifecycle from registration through expiration:

Available

Ready to register

Active

Registered & operational

Grace Period

30 days to renew

Redemption

30 days recovery

Deleted

Available again

Security & Compliance

SOC 2 Type II Certified - Our platform meets the highest standards for security, availability, and confidentiality.

Security Features

🔐

Multi-Factor Authentication

TOTP-based 2FA for all accounts with backup codes.

🛡️

DDoS Protection

Enterprise-grade DDoS mitigation on all endpoints.

📝

Audit Logging

Complete audit trail of all registry operations.

🔒

Encryption

TLS 1.3 in transit, AES-256 at rest.

Compliance

  • ✓ SOC 2 Type II Certified
  • ✓ GDPR Compliant
  • ✓ CCPA Compliant
  • ✓ PCI DSS Level 1 (Payment Processing)
  • ✓ ISO 27001 Certified
  • ✓ ICANN Accredited

Support Resources

📧

Email Support

[email protected]
Response within 24 hours

💬

Live Chat

Available Mon-Fri 9AM-5PM EST
Enterprise clients 24/7

📚

Knowledge Base

500+ articles and tutorials
Video guides available

🚨

Emergency Support

24/7 for critical issues
Enterprise SLA response