# name.com Core API ## Docs - [Changelog](https://docs.name.com/api/v1/changelog.md): name.com CORE API updates and announcements - [API Overview](https://docs.name.com/api/v1/overview.md): Complete overview of name.com Core API structure, environments, and key features - [Check Account Balance](https://docs.name.com/api/v1/reference/account-info/check-account-balance.md): Returns the current account credit balance for the authenticated user. - [Create Account](https://docs.name.com/api/v1/reference/accounts/create-account.md): Creates a new sub-account under your authenticated reseller account and returns API credentials for the new account. This endpoint is only available to approved reseller accounts. Contact name.com support to request access. - [List Unverified Contacts](https://docs.name.com/api/v1/reference/contact-verification/list-unverified-contacts.md): Returns a list of contacts, related to domains within your account, that require verification as per ICANN procedures. When a new domain is created, unverified contacts are not immediately available in API responses. Records are added by a scheduled process that runs approximately every 10 minutes.… - [Resend Contact Verification Email](https://docs.name.com/api/v1/reference/contact-verification/resend-verification-email.md): Resend the contact verification email for a pending verification record. - [Verify Contact](https://docs.name.com/api/v1/reference/contact-verification/verify-contact.md): Use this API to verify a contact. This API is only available to approved reseller accounts. Contact name.com support to request access. - [Create Record](https://docs.name.com/api/v1/reference/dns/create-record.md): Adds a new DNS record to the specified domain zone. Provide the record type (e.g. A, MX, CNAME), host, value, and TTL. This is used for configuring domain-based services such as email, website hosting, or third-party verifications. - [Delete Record](https://docs.name.com/api/v1/reference/dns/delete-record.md): Removes a DNS record by ID. Often used during cleanup operations or when replacing outdated DNS settings with updated records. - [Get Record](https://docs.name.com/api/v1/reference/dns/get-record.md): Retrieves details of a specific DNS record. - [List Records](https://docs.name.com/api/v1/reference/dns/list-records.md): Lists all DNS records for a specified domain. - [Update Record](https://docs.name.com/api/v1/reference/dns/update-record.md): Replaces an existing DNS record with new data. This is a full overwrite — all required fields (host, type, answer, ttl) must be included in the request body. If you omit a field, the existing value will not be preserved and the request may fail. Use [GetRecord](/api/v1/reference/dns/get-record) befo… - [Create DNSSEC](https://docs.name.com/api/v1/reference/dnssecs/create-dnssec.md): Adds (registers) a new DNSSEC DS record for a domain. - [Delete DNSSEC](https://docs.name.com/api/v1/reference/dnssecs/delete-dnssec.md): Deletes a DNSSEC record from a domain. - [Get DNSSEC](https://docs.name.com/api/v1/reference/dnssecs/get-dnssec.md): Retrieves details of a specific DNSSEC record for a domain. - [List DNSSECs](https://docs.name.com/api/v1/reference/dnssecs/list-dnssecs.md): Lists all DNSSEC (DS) records configured for a domain. - [Check Domain Claims](https://docs.name.com/api/v1/reference/domain-info/check-domain-claims.md): Performs the actual claims check for a specific domain. This endpoint checks if a specific domain has trademark claims against it, returning detailed information about any matching trademarks and their holders. Use this to verify if a domain can be registered without trademark conflicts. Please see… - [Get Specific TLD Requirements](https://docs.name.com/api/v1/reference/domain-info/get-specific-tld-requirements.md): Returns the registration requirements some general information for a specific TLD. The response contains a detailed description of eligibility criteria and a fields object with all required and optional fields, including validation rules, conditional logic, and nested field structures. Provide the T… - [Get TLD Requirements as JSON Schema](https://docs.name.com/api/v1/reference/domain-info/get-specific-tld-requirements-v2.md): Returns the registration requirements as a JSON Schema (Draft 7) document. This endpoint is designed for form generation and validation libraries that consume JSON Schema directly. - [Check Availability](https://docs.name.com/api/v1/reference/domains/check-availability.md): CheckAvailability will check a list of domains to see if they are purchasable. A Maximum of 50 domains can be specified. - [Create Domain](https://docs.name.com/api/v1/reference/domains/create-domain.md): Registers a new domain under your account. You must provide the `domain.domainName` at a bare minimum to register. For premium or special-priced domains, the purchase_price must also be included to confirm cost. This endpoint is commonly used to programmatically onboard new domains through user si… - [Disable Autorenew](https://docs.name.com/api/v1/reference/domains/disable-autorenew.md): Turns off automatic renewal for a domain. **DEPRECATED** This endpoint is deprecated in favor of the new UpdateDomain API. This will be removed in a future release. - [Disable Whois Privacy](https://docs.name.com/api/v1/reference/domains/disable-whois-privacy.md): Disables WHOIS privacy protection on a domain. **DEPRECATED** This endpoint is deprecated in favor of the new UpdateDomain API. This will be removed in a future release. - [Enable Autorenew](https://docs.name.com/api/v1/reference/domains/enable-autorenew.md): Turns on automatic renewal for a domain. **DEPRECATED** This endpoint is deprecated in favor of the new UpdateDomain API. This will be removed in a future release. - [Enable Whois Privacy](https://docs.name.com/api/v1/reference/domains/enable-whois-privacy.md): Enables WHOIS privacy protection on a domain. **DEPRECATED** This endpoint is deprecated in favor of the new UpdateDomain API. This will be removed in a future release. - [Get Auth Code For Domain](https://docs.name.com/api/v1/reference/domains/get-auth-code-for-domain.md): Retrieves the transfer authorization code (EPP code) for a domain. - [Get Domain](https://docs.name.com/api/v1/reference/domains/get-domain.md): Retrieves detailed information for a specific domain in your account. - [Get Pricing For Domain](https://docs.name.com/api/v1/reference/domains/get-pricing-for-domain.md): Retrieves the registration and renewal pricing for a given domain. - [List Domains](https://docs.name.com/api/v1/reference/domains/list-domains.md): Lists all domains in your account (basic details for each domain). - [Lock Domain](https://docs.name.com/api/v1/reference/domains/lock-domain.md): Locks a domain to prevent it from being transferred. **DEPRECATED** This endpoint is deprecated in favor of the new UpdateDomain API. This will be removed in a future release. - [Purchase Privacy](https://docs.name.com/api/v1/reference/domains/purchase-privacy.md): Adds or renews WHOIS privacy protection for a domain. This is used to ensure personal contact details remain hidden from public WHOIS lookups. If WHOIS privacy is already enabled, this will extend the protection. If it’s not yet active, this will both purchase and enable the service. This is a bil… - [Renew Domain](https://docs.name.com/api/v1/reference/domains/renew-domain.md): Renews an existing domain for an additional registration period. Include the domain name and renewal term. If the domain has non-standard pricing (e.g. premium), the purchasePrice must be passed. This is typically used to extend ownership before a domain’s expiration. - [Search](https://docs.name.com/api/v1/reference/domains/search.md): Searches for domain name suggestions based on a keyword or term. Important: Do not encode the `:` in the path. Use `/core/v1/domains:search`, not `/core/v1/domains%3Asearch`. - [Set Contacts](https://docs.name.com/api/v1/reference/domains/set-contacts.md): Updates WHOIS contact information for a domain. This includes the registrant, administrative, technical, and billing contacts. All contact objects must be complete — partial updates are not supported. You should fetch the existing contact data first (e.g., via [GetDomain](/api/v1/reference/domains… - [Set Nameservers](https://docs.name.com/api/v1/reference/domains/set-nameservers.md): SetNameservers will set the nameservers for the Domain. This operation updates the DNS configuration by changing which nameservers are responsible for the domain's zone. - [Unlock Domain](https://docs.name.com/api/v1/reference/domains/unlock-domain.md): Unlocks a domain to allow it to be transferred. **DEPRECATED** This endpoint is deprecated in favor of the new UpdateDomain API. This will be removed in a future release. - [Update a domain](https://docs.name.com/api/v1/reference/domains/update-a-domain.md): Allows updating of the autorenew, WhoIs Privacy and lock status of the specified domain. The request requires one, or any combination of the parameters in order to pass validation. If any of the requested updates failed, the domain will be returned to it's original state. - [Zone Check](https://docs.name.com/api/v1/reference/domains/zone-check.md): Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain's availability significantly faster than live registry checks. For definitive, real-time availability and pr… - [Create Email Forwarding](https://docs.name.com/api/v1/reference/email-forwardings/create-email-forwarding.md): Creates a new email forwarding rule for a domain, such as redirecting info@example.com to an external inbox. If this is the first email forwarding rule created for the domain, the API may also update your MX records automatically to enable mail routing. The alias must not conflict with existing em… - [Delete Email Forwarding](https://docs.name.com/api/v1/reference/email-forwardings/delete-email-forwarding.md): Deletes an email forwarding rule from a domain. - [Get Email Forwarding](https://docs.name.com/api/v1/reference/email-forwardings/get-email-forwarding.md): Retrieves the details of a specific email forwarding entry. - [List Email Forwardings](https://docs.name.com/api/v1/reference/email-forwardings/list-email-forwardings.md): Returns a paginated list of all email forwarding rules for a domain. - [Update Email Forwarding](https://docs.name.com/api/v1/reference/email-forwardings/update-email-forwarding.md): Updates the destination email address for an existing forwarding rule. - [Hello](https://docs.name.com/api/v1/reference/hello/hello.md): Returns basic information about the API server (useful for testing connectivity and version checks). - [Get Order](https://docs.name.com/api/v1/reference/orders/get-order.md): Fetches full details about a specific order using its ID. This includes domains, prices, and timestamps. Useful for confirming transactions, receipts, or generating invoices. - [List Orders](https://docs.name.com/api/v1/reference/orders/list-orders.md): Retrieves a list of all orders placed in the account. - [Download Premium Domain Lists](https://docs.name.com/api/v1/reference/premium-domains/download-premium-domain-lists.md): Gets a pre-signed URL that will allow a user to download a list of premium domains, with their registration and renewal pricing. **Please Note:** The pre-signed URL will only be valid for 10 minutes. This endpoint is only available to approved reseller accounts. Contact name.com support to request a… - [Process Refund](https://docs.name.com/api/v1/reference/refunds/process-refund.md): Deletes eligible domains and security products during the Add Grace Period (AGP) and automatically issues refunds for the associated order items. - [TLD Price List](https://docs.name.com/api/v1/reference/tld-pricing/tld-price-list.md): This endpoint returns an alphabetical list of all TLDs supported by name.com, including pricing for each supported order type. All prices are in US Dollars (USD) and apply to non-premium domains. name.com provides three pricing types for each TLD: - Account-Level Pricing - Your price, including any… - [Cancel external transfer out](https://docs.name.com/api/v1/reference/transfers/cancel-external-transfer-out.md): Cancels an outbound transfer for the given domain. Use this when the domain is being transferred out of name.com (losing registrar) to another (gaining) registrar and the registrant or reseller wants to cancel that transfer. The endpoint validates that the domain exists and belongs to the authentica… - [Cancel Transfer](https://docs.name.com/api/v1/reference/transfers/cancel-transfer.md): Cancels a pending transfer request. This can be used if the transfer was initiated in error or if the authorization code provided was incorrect. The price of the transfer will refund the amount to account credit. - [Create Internal Transfer In](https://docs.name.com/api/v1/reference/transfers/create-internal-transfer-in.md): Pulls a domain from another [name.com](https://www.name.com) account into your reseller (gaining) account using a valid authorization code. This is an **internal** name.com-to-name.com move; it is separate from [Create Transfer](/api/v1/reference/transfers/create-transfer), which brings domains in f… - [Create Transfer](https://docs.name.com/api/v1/reference/transfers/create-transfer.md): Initiates a domain transfer into your name.com account from another registrar. You must provide the domain name and its valid transfer authorization code (EPP code). The domain must not be locked or under any transfer restrictions (e.g. clientTransferProhibited). If successful, the transfer is su… - [Get Transfer](https://docs.name.com/api/v1/reference/transfers/get-transfer.md): Retrieves details of a specific domain transfer request. - [List Transfers](https://docs.name.com/api/v1/reference/transfers/list-transfers.md): Returns all domain transfer requests for the account, including in-progress and recent transfers. - [Create URLForwarding](https://docs.name.com/api/v1/reference/url-forwardings/create-urlforwarding.md): Sets up a new URL forwarding (redirect) for a domain or subdomain. If this is the first URL forwarding entry, it may modify the A records for the domain accordingly. Note that changes may take up to 24 hours to fully propagate. - [Delete URLForwarding](https://docs.name.com/api/v1/reference/url-forwardings/delete-urlforwarding.md): Removes a URL forwarding configuration from the domain. This operation cannot be undone. **Deprecated.** Use [Delete URL Forwarding by ID](/api/v1/reference/url-forwardings/delete-urlforwarding-by-id) instead. - [Delete URL Forwarding by ID](https://docs.name.com/api/v1/reference/url-forwardings/delete-urlforwarding-by-id.md): Removes a URL forwarding configuration by ID. The domain must be owned by the authenticated account. This operation cannot be undone. - [Get URLForwarding](https://docs.name.com/api/v1/reference/url-forwardings/get-urlforwarding.md): Retrieves the details of a specific URL forwarding configuration. **Deprecated.** Use [Get URL Forwarding by ID](/api/v1/reference/url-forwardings/get-urlforwarding-by-id) instead. - [Get URL Forwarding by ID](https://docs.name.com/api/v1/reference/url-forwardings/get-urlforwarding-by-id.md): Retrieves the details of a specific URL forwarding configuration by ID. The domain must be owned by the authenticated account. - [List URLForwardings](https://docs.name.com/api/v1/reference/url-forwardings/list-urlforwardings.md): Returns all URL forwarding settings configured for a domain. **Deprecated.** Use [List URL Forwardings by domain](/api/v1/reference/url-forwardings/list-urlforwardings-by-domain) instead, which returns entries with an `id` for use with by-ID endpoints. - [List URL Forwardings by domain](https://docs.name.com/api/v1/reference/url-forwardings/list-urlforwardings-by-domain.md): Returns all URL forwarding settings configured for a domain. Each entry includes an `id` that can be used with the URL Forwarding by-ID endpoints to get, update, or delete records. - [Update URLForwarding](https://docs.name.com/api/v1/reference/url-forwardings/update-urlforwarding.md): Modifies an existing URL forwarding rule. Changes may take up to 24 hours to fully propagate. **Deprecated.** Use [Update URL Forwarding by ID](/api/v1/reference/url-forwardings/update-urlforwarding-by-id) instead. - [Update URL Forwarding by ID](https://docs.name.com/api/v1/reference/url-forwardings/update-urlforwarding-by-id.md): Modifies an existing URL forwarding rule by ID. The domain must be owned by the authenticated account. Changes may take up to 24 hours to fully propagate. - [Create Vanity Nameserver](https://docs.name.com/api/v1/reference/vanity-nameservers/create-vanity-nameserver.md): Register a new vanity nameserver for the specified domain. - [Delete Vanity Nameserver](https://docs.name.com/api/v1/reference/vanity-nameservers/delete-vanity-nameserver.md): Deletes a vanity nameserver from the domain’s registry settings. This operation might fail if the registry detects the nameserver is still in use. - [Get Vanity Nameserver](https://docs.name.com/api/v1/reference/vanity-nameservers/get-vanity-nameserver.md): Retrieves details for a of a specific vanity nameserver (including its IP addresses). - [List Vanity Nameservers](https://docs.name.com/api/v1/reference/vanity-nameservers/list-vanity-nameservers.md): Lists all vanity nameserver hostnames configured for a domain. - [Update Vanity Nameserver IP](https://docs.name.com/api/v1/reference/vanity-nameservers/update-vanity-nameserver-ip.md): Updates the glue record IP addresses for a vanity nameserver. - [Contact Verification Status Change](https://docs.name.com/api/v1/reference/webhook-notifications/contact-verification-status-change.md): This is the payload that will be sent to the subscribed URL, when a change to contact verification status occurs. This will trigger on both verified and unverified contact status change events. - [Delete Subscription](https://docs.name.com/api/v1/reference/webhook-notifications/delete-subscription.md): Removes a webhook subscription from the account. - [Domain Lock Status Change](https://docs.name.com/api/v1/reference/webhook-notifications/domain-lock-status-change.md): Sent when a domain lock is added or removed, which may restrict or lift normal operations. This event is triggered automatically whenever covered lock types (e.g., compliance or verification holds) are added or removed. A webhook payload is delivered to the subscribed endpoint, providing details abo… - [Domain Registry Rejection](https://docs.name.com/api/v1/reference/webhook-notifications/domain-registry-rejection.md): Sent when you have subscribed to this event on your account, and a domain **create** request fails after asynchronous registry processing. Most registrations complete successfully at create time; this webhook covers the uncommon case where processing completes later with a failure. - [Domain Transfer Internal In Status Change](https://docs.name.com/api/v1/reference/webhook-notifications/domain-transfer-internal-in-status-change.md): Sent when you have subscribed to the event on your account, and a name.com domain transfers into your account. - [Domain Transfer Out Status Change](https://docs.name.com/api/v1/reference/webhook-notifications/domain-transfer-out-status-change.md): Sent when you have subscribed to the event on your account, and a domain transfer OUT from name.com to another registrar has a status change. Status may be "initiated" (transfer out was started), "completed" (domain has been removed from name.com), or "canceled" (transfer out was canceled before com… - [Domain Transfer In Status Change](https://docs.name.com/api/v1/reference/webhook-notifications/domain-transfer-status-change.md): Sent when you have subscribed to the event on your account, and a domain transfer IN to name.com is processing. This webhook reports status changes for transfers where name.com is the gaining registrar (i.e., transfers into your name.com account). - [Get Subscribed Notifications](https://docs.name.com/api/v1/reference/webhook-notifications/get-subscribed-notifications.md): Retrieves all active webhook subscriptions on the account. - [Modify Subscription](https://docs.name.com/api/v1/reference/webhook-notifications/modify-subscription.md): Updates an existing webhook’s configuration. This may include changing the callback URL or updating whether the webhook is currently active. - [Subscribe To Notification](https://docs.name.com/api/v1/reference/webhook-notifications/subscribe-to-notification.md): Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes. Supported webhook event names: - `account.credit… - [Account Credit Balance Change](https://docs.name.com/api/v1/reference/webhook-notifications/webhook-for-credit-balance-changes.md): This is the payload that will be sent to the subscribed URL, when a changed to the amount of account credit for an account changes. This will trigger on both increases and decreases in account credit for the account. - [Authentication](https://docs.name.com/guides/authentication.md): How to authenticate with the name.com Core API using HTTP Basic Auth. - [Claims Flow](https://docs.name.com/guides/claims-flow.md): 4-step guide with examples on how to register domains with claims. Note: Example domain names, trademarks, and other data shown below are dummy data used for illustrative purposes only. - [Contact Verification Compliance](https://docs.name.com/guides/contact-verification.md): ICANN contact verification email requirements, reseller logging obligations, and how to integrate contact verification endpoints + webhooks without duplicating documentation. - [Understanding Domain Locks](https://docs.name.com/guides/domain-locks.md): Overview of verification, compliance/security, and customer-controlled domain locks, including when they apply and their impact. - [Funding Your name.com Account](https://docs.name.com/guides/funding-your-namecom-account.md): How to fund your account using Account Credit via ACH or wire transfer. - [Getting Started](https://docs.name.com/guides/getting-started.md): Learn how to authenticate and make your first API call with name.com Core API - [HMAC Signature Verification](https://docs.name.com/guides/hmac-examples.md): Practical examples to verify name.com webhook HMAC signatures including header format, generation steps, and security best practices in common programming languages. - [v4 to CORE API Migration](https://docs.name.com/guides/migration-guide.md): Complete guide for migrating from the v4 API to the name.com Core API - [Reseller Quickstart](https://docs.name.com/guides/quickstart.md): A minimal, production-ready flow to sell domains with the name.com Core API from discovery, purchase, management, and renewals. - [Quickstart TLD List](https://docs.name.com/guides/quickstart-recommended-tlds.md): An alphabetized list of TLDs we recommend for a fast MVP domain storefront implementation. - [Refunds Flow](https://docs.name.com/guides/refunds-flow.md): 2-step guide with examples on how to delete and refund domains. - [Registrant Communications](https://docs.name.com/guides/registrant-communications.md): Registrant email obligations (verification, renewals, transfers) plus recommended contact approaches and communication options for resellers. - [Testing Environment](https://docs.name.com/guides/testing-environment.md): How to use the sandbox environment for safe integration testing, plus known constraints and differences from production. - [name.com Core API Documentation](https://docs.name.com/index.md): Modern domain management API for developers, SaaS platforms, and businesses - [API Docs MCP](https://docs.name.com/integrations/mcp/api-docs-mcp.md): Read‑only MCP server that lets agents search and cite the name.com Core API documentation in chat. It does not execute API calls; use the name.com Core API MCP for live operations. - [name.com MCP](https://docs.name.com/integrations/mcp/namecom-mcp.md): The name.com Model Context Protocol (MCP) server lets AI agents (e.g., Cursor, Claude Desktop) safely call name.com Core API operations on your behalf. This enables assistants to look up account info, manage domains, and perform other tasks programmatically with your authorization. - [FAQ & Troubleshooting](https://docs.name.com/resources/faq.md): Frequently asked questions and troubleshooting guide for name.com Core API ## OpenAPI Specs - [namecom.api](https://docs.name.com/namecom.api.yaml) - [openapi](https://docs.name.com/api-reference/openapi.json)