Skip to content
Domain Info
/
Get Specific TLD Requirements

name.com Core API (1.2.0)

RESTful API for managing domains, DNS records, and related services at name.com. Access via HTTPS at api.name.com (production) or api.dev.name.com (testing). Supports standard authentication, rate-limited to 20 requests/second.

Download OpenAPI description
namecom.api.json
namecom.api.yaml
Overview
Account Services

accountservices@name.com

Terms of Service

Languages
Servers
Mock server

https://docs.name.com/_mock/coreapi/namecom.api/

Testing

https://api.dev.name.com/

Hello

Use the Hello endpoint to verify that your API connection and credentials are working properly. This simple call returns a success message (along with server time and version info) to confirm the API is reachable and authenticated.

Operations

Account Info

Use Account Info endpoints to retrieve basic information about your name.com account. For example, you can check your account’s current credit balance and other account details using these endpoints.

Operations

Accounts

Use Accounts endpoints (available upon request) to manage sub-accounts under your main account. For example, resellers can programmatically create new customer accounts with their own login credentials and permissions.

Operations

Domains

Use Domains endpoints to search for domain availability, register new domains, and manage existing domains.

Operations

DNS

Use DNS endpoints to manage DNS records for your domains. You can list all existing DNS records for a domain and create, update, or delete records as needed.

Operations

DNSSECs

Use DNSSEC endpoints to configure DNS Security Extensions for your domains. These endpoints allow you to add, retrieve, or remove DNSSEC records.

Operations

Email Forwardings

Use Email Forwardings endpoints to set up and manage email forwarding addresses on your domains.

Operations

URL Forwardings

Use URL Forwardings endpoints to control URL redirection settings for your domains.

Operations

Vanity Nameservers

Use Vanity Nameservers endpoints to configure custom nameserver hostnames (glue records) for your domains.

Operations

Transfers

Use Transfers endpoints to move domains into your name.com account. Start by creating a transfer request, then monitor and manage the status of pending transfers. You can also cancel a transfer if needed.

Operations

Orders

Use Orders endpoints to review and track purchases made via the API.

Operations

Webhook Notifications

Use Webhook Notification endpoints to subscribe to real-time notifications for account and domain events. This keeps your application updated on important changes without polling the API.

OperationsWebhooks

Domain Info

Use Domain Info endpoints to retrieve information about TLD-specific requirements and registration rules. These endpoints help you understand what fields, documents, or constraints are needed to successfully register domains across different TLDs.

Operations

Get Specific TLD Requirements

Request

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 TLD as a path parameter to retrieve its complete registration requirements. Useful when you only need details for one TLD (e.g., when a user selects .fr from a dropdown).

Security
BasicAuth
Path
tldstringrequired

TLD indicates which domain requirements to retrieve (without the dot prefix, e.g., 'fr' for .fr domains).

Example: fr
curl -i -X GET \
  -u <username>:<password> \
  https://docs.name.com/_mock/coreapi/namecom.api/core/v1/domaininfo/requirements/fr

Responses

The complete registration requirements for the specified TLD.

Bodyapplication/json
tldInfoobject(ResellerTldInfo)required

General information about a specific TLD. These are not registration requirements, but contain useful information for domain reseller and domain registrants in general.

tldInfo.​tldstringrequired

The TLD this information relates to.

Example: ".fr"
tldInfo.​ccTldbooleanrequired

Whether the TLD is a Country Code TLD.

Example: true
tldInfo.​supportsTransferLockbooleanrequired

Whether the TLD supports implementing a Transfer Lock.

Example: true
tldInfo.​supportsDnssecbooleanrequired

Whether the TLD supports DNSSEC.

Example: true
tldInfo.​supportsPremiumbooleanrequired

Whether there are premium domains for this TLD.

Example: true
tldInfo.​expirationGracePeriodnumber(int32)required

The number of days you have to renew your domain after it has expired, but before it is removed from your account.

Example: 25
tldInfo.​allowedRegistrationYearsArray of numbersrequired

The years that a domain is allowed to be registered for.

Example: [1,3,5,8,10]
tldInfo.​idnLanguagesobjectrequired

The IND Languages that the TLD supports (if any).

Example: {"DE":"German","DK":"Danish","ES":"Spanish","IT":"Italian","JP":"Japanese"}
tldInfo.​idnLanguages.​property name*stringadditional property
requirementsobject(Requirement)required

The registration requirements for this TLD, including required fields, validation rules, and conditional logic.

requirements.​descriptionstringrequired

A detailed description of the registration requirements for this TLD, including eligibility criteria, restrictions, and important notes.

Example: "Required fields to register an .fr domain"
requirements.​fieldsobjectrequired

An object containing all required and optional fields for domain registration, with their validation rules and conditional logic.

requirements.​fields.​property name*object(RequirementField)additional property

A field definition for TLD registration requirements, including validation rules, conditional logic, and nested field structures.

Response
application/json

Example of a complex requirement set with multiple fields, conditional logic, and nested requirements

{
  "tldInfo": {
    "tld": "fr",
    "ccTld": true,
    "supportsTransferLock": true,
    "supportsDnssec": true,
    "supportsPremium": true,
    "expirationGracePeriod": 3,
    "idnLanguages": {},
    "allowedRegistrationYears": [ … ]
  },
  "requirements": {
    "description": "Registration requirements for .fr domains",
    "fields": { … }
  }
}

TLD Pricing

Use TLD Pricing endpoints to retrieve general pricing information for your account.

Operations