Integration Steps

​

Authentication

Authorization: Bearer YOUR_API_TOKEN

​

Base URLs

• Production: https://atom.com/api/registrar/v1
• Development: https://dev.atom.com/api/registrar/v1

​

API Overview

​

Domain Management

• List all domains
• Check domain availability and Atom price (single and bulk)
• Catalog TLD pricing (GET /tld-pricing)
• Register new domains (optional nameservers, privacy, auto-renew, contacts, DNS records in the same request)
• Renew a domain you already hold at Atom
• Get domain details (includes ICANN 60-day lock fields)

​

DNS Management

• List DNS records
• Create, update, and delete DNS records
• Filter DNS records by subdomain and type
• Bulk update and delete DNS records

​

Nameserver Management

• Get current nameservers
• Update nameservers (Atom, Parking, or Custom)

​

Domain Settings

• Get / set registrar transfer lock (GET/PUT /domains/{domain}/lock). Unlocking is dashboard-only.
• Toggle privacy protection
• Toggle auto-renewal
• Manage URL forwarding rules

​

Transfers

• Transfer in with POST /domains/transfer (auth code from the losing registrar)
• Transfer out is not available via API. Unlocking a domain and retrieving an EPP / auth code must be done in the Atom dashboard.

​

DNSSEC

• Get DNSSEC records
• Enable/disable DNSSEC

​

Contacts

• List or search contact handles (?search=, ?name=, ?email=)
• Get a single contact by handle
• Create and update contacts
• Get / assign domain contact roles

​

Common Workflows

​

Registering a Domain

1. Price: Use GET /domains/check/{domain_name} for that label (includes premium). Use GET /tld-pricing for catalog register / renew / transfer prices.
2. Check Availability: Use GET /domains/check/{domain_name} or POST /domains/check-bulk
3. Register Domain: Use POST /domains/register. You may send nameservers, privacy_protect, auto_renew, contacts, and dns_records in the same request.
4. Configure DNS: Use DNS management endpoints if the domain is on Atom nameservers

​

Renewing a Domain

​

Transfer lock

1. GET /domains/{domain_name}/lock returns the customer registrar lock and the ICANN 60-day lock (icann_transfer_lock_expires_at).
2. PUT /domains/{domain_name}/lock with {"locked": true} locks the domain. {"locked": false} returns 403 — unlock and transfer-out are dashboard-only.

​

Managing DNS Records

1. List Records: Use GET /domains/{domain_name}/records to view all DNS records
2. Create Record: Use POST /domains/{domain_name}/records to add new records
3. Update Record: Use PUT /domains/{domain_name}/records/{record_id} to modify existing records
4. Delete Record: Use DELETE /domains/{domain_name}/records/{record_id} to remove records

​

Bulk Operations

• Use PUT /domains/{domain_name}/dns/bulk-update to update multiple DNS records at once
• Use DELETE /domains/{domain_name}/dns/bulk-delete to delete multiple DNS records matching criteria

​

Response Format

{
  "success": true,
  "data": { ... },
  "message": "Operation completed successfully"
}

{
  "success": false,
  "error": "Error Type",
  "message": "Detailed error message"
}

​

Rate Limits

​

Support