API Documentation

Complete API reference for integrating with the Universal Domain Name Registry System. Build powerful applications with our modern REST API.

Registrar Access Required

Full API access is available exclusively to approved registrars and partners. Public endpoints are available for basic queries. To apply for registrar status and obtain complete API credentials, please contact our partnership team.

Domain Management

Register, transfer, and manage domains across multiple TLDs with a unified API interface. Support for bulk operations and automated workflows.

WHOIS Services

Access public WHOIS data for domain availability checks and registrant information queries. Real-time data with global registry support.

DNS Management

Configure DNS records, nameservers, and DNSSEC settings programmatically. Complete DNS hosting with advanced record types.

Real-time Updates

Receive instant notifications about domain events through webhook integrations. Monitor domain status changes and renewals.

Public API Endpoints

The following endpoints are available for public queries without authentication:

GET /api/public/check/{domain}

Check domain availability across supported TLDs

                        GET /api/public/check/example.u

Response:
{
  "domain": "example.u",
  "available": true,
  "tld": "u",
  "premium": false,
  "price": "1.00"
}
                    

GET /api/public/whois/{domain}

Query public WHOIS information for a domain

                        GET /api/public/whois/example.com

Response:
{
  "domain": "example.com",
  "status": "registered",
  "created": "1995-08-14",
  "expires": "2025-08-13",
  "registrar": "Example Registrar Inc."
}
                    

GET /api/public/pricing

Get current TLD pricing information

                        GET /api/public/pricing

Response:
{
  "tlds": [
    {
      "tld": "u",
      "registration": "1.00",
      "renewal": "10.00",
      "transfer": "10.00",
      "currency": "USD"
    }
  ]
}
                    

Registrar API Features

Approved registrars gain access to comprehensive domain management capabilities:

Feature Category	Available Operations
Domain Operations	Registration (1-10 years), Transfers, Renewals, Bulk operations, Lock management
Contact Management	Create/update contacts, WHOIS privacy, Contact verification, Bulk updates
DNS Services	Nameserver management, DNS records, DNSSEC support, Glue records
Advanced Features	Real-time webhooks, Detailed reporting, White-label support, Custom pricing

Authentication & Security

API Security

HTTPS Only: All API communications use TLS encryption
Token Authentication: Secure bearer tokens for authenticated requests
IP Whitelisting: Optional IP-based access restrictions
Rate Limiting: Request throttling to prevent abuse

Best Practices

Store credentials securely using environment variables
Implement proper error handling and retry logic
Use webhook signatures to verify event authenticity
Test thoroughly in OT&E environment first

HTTP Response Codes

Code	Description
200 OK	Request successful
201 Created	Resource successfully created
400 Bad Request	Invalid request parameters
401 Unauthorized	Authentication required or failed
403 Forbidden	Access denied to resource
404 Not Found	Resource not found
429 Too Many Requests	Rate limit exceeded
500 Internal Server Error	Server error - contact support

Ready to Get Started?

Join our registrar program to access the full Unregistry API and start managing domains programmatically.

Apply for Registrar Access