Skip to content

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
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

TLD Pricing

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

Operations

TLD Price List

Request

Get a alphabetical pricing list of all TLDs supported by name.com. The pricing returned will be your account level price in US Dollars (USD) and is the price you pay for non-premium registrations.

Please Note: This is general pricing for domains registered with the specified TLD. Individual domains may have different pricing based on a large number of factors. If you are trying to see pricing for a specific individual domain, you will need to use the Get Pricing For Domain API.

Please note that if null is returned for any of the prices, it means that particular product is unavailable at name.com at the time of the request. For example, if registrationPrice returns as null in the response, it means that name.com is not currently accepting registrations for that TLD.

Any IDN TLDs will return in their unicode format.

Security
BasicAuth
Query
perPageinteger(int32)

Per Page is the number of records to return per request. Per Page defaults to 25.

Default 25
pageinteger(int32)

Page is which page to return.

Default 1
durationnumber(int32)[ 1 .. 10 ]

The number of years to get pricing for. The requested duration must be between 1 and 10 (inclusive). If the duration is not passed in the request, it will default to 1.

Default 5
Example: duration=1
tldsArray of strings[ 1 .. 25 ] items

A list of specific TLDs to get pricing for. Maximum of 25 TLDs can be requested at a time. When querying for IDN TLDs, due to character restrictions within a URL, they must be submitted in ASCII format. This means using "xn--9dbq2a" as opposed to it's unicode equivalent.

curl -i -X GET \
  -u <username>:<password> \
  'https://docs.name.com/_mock/coreapi/namecom.api/core/v1/tldpricing?perPage=25&page=1&duration=1&tlds=string'

Responses

A successful response.

Bodyapplication/json
lastPageinteger(int32)required

LastPage is the identifier for the final page of results. It is only populated if there is another page of results after the current page.

nextPageinteger or null(int32)required

NextPage is the identifier for the next page of results. It is only populated if there is another page of results after the current page.

totalCountinteger(int32)required

TotalCount is total number of results.

frominteger(int32)required

From specifies starting record number on current page.

tointeger(int32)required

To specifies ending record number on current page.

pricingArray of objects(TldPriceListEntry)required
pricing[].​tldstringrequired

The TLD the pricing applies to. For IDN TLDs, this will be the unicode representation of the TLD.

Example: "com"
pricing[].​durationnumber(int32)required

The number of years this pricing is for

Example: 1
pricing[].​registrationPricenumber or null(double)required

This your account level price in US Dollars (USD) and is the price you pay for non-premium registrations. It includes applicable rebates, promotions and/or sales.

Example: 9.99
pricing[].​registrationOriginalPricenumber or null(double)required

Price in US Dollars (USD) before any rebates, promotions and/or sales when registering non-premium domains.

Example: 11.99
pricing[].​renewalPricenumber or null(double)required

This your account level price in US Dollars (USD) and is the price you pay for renewals. It includes applicable rebates, promotions and/or sales.

Example: 9.99
pricing[].​domainRestorationPricenumber or null(double)required

This your account level price in US Dollars (USD) and is the price you pay for domain restorations. It includes applicable rebates, promotions and/or sales.

Example: 120.99
pricing[].​transferInPricenumber or null(double)required

This your account level price in US Dollars (USD) and is the price you pay for transferring a domain to management at name.com. It includes applicable rebates, promotions and/or sales.

Example: 19.99
Response
application/json
{ "lastPage": 0, "nextPage": 0, "totalCount": 0, "from": 0, "to": 0, "pricing": [ {} ] }