# Atom API Reference

## Docs

- [Domain Appraisal](https://apidocs.atom.com/api-reference/appraisal_apis/domain_appraisal.md): Get an AI-powered appraisal for any domain name. Returns an estimated market value, domain quality score, key signals (length, brandability, extension), and root word analysis.
- [Confirm Order](https://apidocs.atom.com/api-reference/parnership_apis/confirm_order.md): Confirm the purchase once payment has been collected and funds are verified. This finalizes the transaction and secures the transfer authorization code for your buyer.
- [Domain Data](https://apidocs.atom.com/api-reference/parnership_apis/domain_data.md): Retrieve detailed information about a specific domain, including pricing, category, availability status, and listing details.
- [Get Order By ID](https://apidocs.atom.com/api-reference/parnership_apis/get_order_by_id.md): Retrieve list of all partnership orders, including key details such as order status, total price, and created date. Use this endpoint to power order history views or internal reconciliation tools.
- [Get Orders](https://apidocs.atom.com/api-reference/parnership_apis/get_orders.md): Retrieve list of all partnership orders, including key details such as order status, total price, and created date. Use this endpoint to power order history views or internal reconciliation tools.
- [Get Transfer Auth Code](https://apidocs.atom.com/api-reference/parnership_apis/get_transfer_auth_code.md): Retrieve the authorization code needed to transfer a purchased domain to the buyer's registrar of choice.
- [Hold Domain](https://apidocs.atom.com/api-reference/parnership_apis/hold_domain.md): Reserve a domain when a customer adds it to their cart or while you verify payment. The hold prevents the domain from being purchased by another buyer while you process the transaction.
- [Partnership Search](https://apidocs.atom.com/api-reference/parnership_apis/partnership_search.md): Browse and search available domains in the Atom marketplace. Filter by keyword, paginate through results, and discover premium domain names ready for purchase.
- [Semantic Search](https://apidocs.atom.com/api-reference/parnership_apis/semantic_search.md): Discover domains using natural language queries. Describe what you're looking for — such as 'names for a healthcare startup' or 'short brandable tech names' — and get back the most relevant matches from Atom's marketplace using advanced AI-powered semantic search.
- [UnHold Domain](https://apidocs.atom.com/api-reference/parnership_apis/unhold_domain.md): Release a previously reserved domain back to the marketplace. Use this if the customer decides not to proceed with the purchase.
- [Bulk delete DNS records](https://apidocs.atom.com/api-reference/registrar_apis/bulk_delete_dns.md): Delete all DNS records matching specific subdomain and type criteria. Type parameter is required.
- [Bulk update DNS records](https://apidocs.atom.com/api-reference/registrar_apis/bulk_update_dns.md): Update all DNS records matching specific subdomain and type criteria. Updates content and optionally TTL for all matching records.
- [Check multiple domains availability](https://apidocs.atom.com/api-reference/registrar_apis/check_bulk_domains.md): Check availability for multiple domain names (max 50 domains per request). Some results may be cached.
- [Check domain availability](https://apidocs.atom.com/api-reference/registrar_apis/check_domain.md): Check if a single domain name is available for registration. Some results may be cached.
- [Create a contact](https://apidocs.atom.com/api-reference/registrar_apis/create_contact.md): Creates a new registrar contact handle. If no primary registrant contact (RegistrantUser) exists for the account, this request creates one. Subsequent calls create additional contact handles. The contact is also registered with the upstream registrar (RealtimeRegister).
- [Create DNS record](https://apidocs.atom.com/api-reference/registrar_apis/create_dns_record.md): Create a new DNS record for the domain. Supports A, AAAA, CNAME, MX, TXT and other standard record types.
- [Create URL forward](https://apidocs.atom.com/api-reference/registrar_apis/create_url_forward.md): Create a new URL forwarding rule for a domain. Supports permanent (301) and temporary (302) redirects.
- [Delete DNS record](https://apidocs.atom.com/api-reference/registrar_apis/delete_dns_record.md): Delete a specific DNS record by its ID.
- [Delete URL forward](https://apidocs.atom.com/api-reference/registrar_apis/delete_url_forward.md): Delete a specific URL forwarding rule by its ID.
- [Disable DNSSEC](https://apidocs.atom.com/api-reference/registrar_apis/disable_dnssec.md): Disable DNSSEC for a domain. Required before changing nameservers.
- [Enable DNSSEC](https://apidocs.atom.com/api-reference/registrar_apis/enable_dnssec.md): Enable DNSSEC for a domain.
- [Filter DNS records](https://apidocs.atom.com/api-reference/registrar_apis/filter_dns_records.md): Filter DNS records by subdomain and/or record type. Useful for finding specific records.
- [Get DNSSEC records](https://apidocs.atom.com/api-reference/registrar_apis/get_dnssec.md): Get DNSSEC DS records for a domain. Returns parsed records with algorithm and digest type names.
- [Get domain details](https://apidocs.atom.com/api-reference/registrar_apis/get_domain_details.md): Get detailed information about a specific domain including status, expiry date, nameservers, DNSSEC status, and contact information.
- [Get domain nameservers](https://apidocs.atom.com/api-reference/registrar_apis/get_nameservers.md): Get the current nameservers configured for a domain. Returns nameserver list and type (atom, parking, or custom).
- [List contacts](https://apidocs.atom.com/api-reference/registrar_apis/list_contacts.md): Returns all contact handles associated with the authenticated user — the primary registrant contact (RegistrantUser) plus any additional contact handles.
- [List DNS records](https://apidocs.atom.com/api-reference/registrar_apis/list_dns_records.md): Get all active DNS records for a domain. Syncs with PowerDNS before returning results.
- [List all domains](https://apidocs.atom.com/api-reference/registrar_apis/list_domains.md): Get a paginated list of all domains owned by the authenticated user. Supports search, filtering by extension, and pagination.
- [Get URL forwarding rules](https://apidocs.atom.com/api-reference/registrar_apis/list_url_forwards.md): Get all active URL forwarding rules configured for a domain.
- [Register a new domain](https://apidocs.atom.com/api-reference/registrar_apis/register_domain.md): Register a new domain name. Performs a real-time availability check, processes payment (account balance or saved card), and registers the domain with a 60-day transfer lock and parking nameservers.
- [Toggle domain auto-renewal](https://apidocs.atom.com/api-reference/registrar_apis/toggle_auto_renew.md): Enable or disable automatic renewal for a domain before expiration.
- [Toggle domain privacy protection](https://apidocs.atom.com/api-reference/registrar_apis/toggle_privacy.md): Enable or disable WHOIS privacy protection for a domain. May require contact verification via email.
- [Transfer a domain in](https://apidocs.atom.com/api-reference/registrar_apis/transfer_domain.md): Initiate a domain transfer-in to Atom Registrar. Validates eligibility (domain not already owned, no transfer in progress, correct auth code, no transfer lock, not registered within 60 days), resolves pricing, processes payment via account balance or saved card, then initiates the transfer with the…
- [Bulk transfer domains in](https://apidocs.atom.com/api-reference/registrar_apis/transfer_domain_bulk.md): Initiate transfer-in for up to 10 domains in a single request. All domains are validated and priced first; a single payment is charged for the aggregate total. Transfers are then initiated one by one. Domains that fail to transfer are individually refunded to your account balance (if paid via balanc…
- [Update a contact](https://apidocs.atom.com/api-reference/registrar_apis/update_contact.md): Updates an existing contact handle. Only the fields provided in the request body are changed — omitted fields keep their current values. If the registrar requires email verification for the change (e.g. email address updates), a 202 response is returned and the update is applied once the user approv…
- [Update DNS record](https://apidocs.atom.com/api-reference/registrar_apis/update_dns_record.md): Update an existing DNS record. All fields are optional; only provided fields will be updated.
- [Update domain contacts](https://apidocs.atom.com/api-reference/registrar_apis/update_domain_contacts.md): Assign contact handles to one or more roles on a domain — `registrant`, `admin`, `billing`, and/or `tech`. At least one role must be supplied; roles that are omitted remain unchanged.
- [Update domain nameservers](https://apidocs.atom.com/api-reference/registrar_apis/update_nameservers.md): Update nameservers for a domain. Supports atom, parking, or custom nameservers. Automatically disables DNSSEC if switching nameserver types.
- [Add Discount](https://apidocs.atom.com/api-reference/seller_apis/add_discount.md): Apply a discount to a domain listing to attract more buyers. Set a percentage discount that will be displayed on the domain's sale page.
- [Add Domain](https://apidocs.atom.com/api-reference/seller_apis/add_domain.md): Add a new domain to Atom. For premium listing, a coin will be deducted from your account and the domain will be submitted for review. For a Standard or Geo listing, the domain landing page will immediately go live
- [All Sales](https://apidocs.atom.com/api-reference/seller_apis/all_sales.md): Retrieve your complete sales history on Atom, including domain names, sale prices, and transaction dates.
- [Assign Primary Category](https://apidocs.atom.com/api-reference/seller_apis/assign_primary_category.md): Assign an industry category to a domain listing. This helps buyers find your domain when browsing by industry.
- [Boost Domain](https://apidocs.atom.com/api-reference/seller_apis/boost_domain.md): Boost your Premium domains (Standard Boost or Super Boost). Coins will be deducted from your account balance
- [Categories](https://apidocs.atom.com/api-reference/seller_apis/categories.md): Retrieve the list of available categories for organizing your domain listings.
- [Domain Search](https://apidocs.atom.com/api-reference/seller_apis/domain/search.md): Search your domain portfolio by keyword, category, or name type. Use this to find specific domains within your listings.
- [Domain Analytics](https://apidocs.atom.com/api-reference/seller_apis/domain_analytics.md): Retrieve performance analytics for your domain listings, including page views, shortlists, and engagement metrics.
- [Domain Details](https://apidocs.atom.com/api-reference/seller_apis/domain_details.md): Retrieve detailed information for a specific domain in your portfolio, including pricing, category, and listing status.
- [Domains](https://apidocs.atom.com/api-reference/seller_apis/domains.md): Retrieve your domain portfolio listings. Filter by listing type (Premium, Standard, or Geo) and paginate through results.
- [Get Grade Domain Result](https://apidocs.atom.com/api-reference/seller_apis/get_grade_domain_result.md): Retrieve the results of a previously submitted domain grading batch, including quality scores and brand-fit assessments.
- [Primary Categories](https://apidocs.atom.com/api-reference/seller_apis/primary_categories.md): Retrieve the list of primary industry categories available for domain classification.
- [Remove Domain](https://apidocs.atom.com/api-reference/seller_apis/remove_domain.md): Remove a Standard listing from your account. This method only supports Standard listings. For removing Premium Listings, please contact Atom team to give a 7 day removal notice
- [Syndication Authorized Domains](https://apidocs.atom.com/api-reference/seller_apis/syndication_authorized_domains.md): Retrieve domains from your portfolio that are authorized for syndication and listing on external marketplaces and partner platforms.
- [Update Description](https://apidocs.atom.com/api-reference/seller_apis/update_description.md): Add or update a marketing description for your domain listing. A compelling description helps attract buyers.
- [Update Selling Price](https://apidocs.atom.com/api-reference/seller_apis/update_selling_price.md): Update the selling price of a domain. There are no restrictions for Standard Listings. For Premium Listings, the selling price must be within the allowed range as per your Membership Tier (e.g. Silver, Gold, Platinum)
- [Upload Grade Domains](https://apidocs.atom.com/api-reference/seller_apis/upload_grade_domains.md): Submit a batch of domains for AI-powered quality grading. Get brand-fit scores and quality assessments to help decide which domains to list.
- [Veirfy DNS](https://apidocs.atom.com/api-reference/seller_apis/verify_dns.md): Verify that DNS records are correctly configured for a domain in your portfolio.
- [Trademark Search](https://apidocs.atom.com/api-reference/trademark_apis/trademark_search.md): Search the USPTO trademark database to check for potential conflicts before registering or purchasing a domain name. Filter by filing status, international class, and more.
- [Partnership API Guide](https://apidocs.atom.com/guides/partnership_apis.md)
- [Integration Steps](https://apidocs.atom.com/guides/registrar_apis.md)
- [Introduction](https://apidocs.atom.com/introduction.md)

## OpenAPI Specs

- [openapi](https://apidocs.atom.com/api-reference/openapi.json)