Accounts

Name.com Core API (1.0.1)

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

Create Account

Request

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.

Bodyapplication/jsonrequired

CreateAccountRequest has the information that is needed to create an account with the CreateAccount function.

accountobject(Account)required

The account details for the new account being created.

Example: {"accountName":"reseller_subaccount","password":"SecureP4ss!","contacts":{"registrant":{"firstName":"Jane","lastName":"Doe","address1":"123 Main St.","city":"Denver","state":"CO","zip":"12345","country":"US","phone":"+1.3035551212","email":"admin@example.net"}}}
account.​accountIdinteger(int32)

AccountId is the unique id of account.

Example: 12345
account.​accountNamestring[ 6 .. 60 ] characters

AccountName is the unique name of the account. Minimum length is 6 characters, maximum length is 60.

Example: "reseller_subaccount"
account.​autoRenewboolean(AutoRenew reflects account setting auto renew)

When set to true, domains in this account will be automatically renewed before expiration.

Default true
account.​contactsobject(Contacts)

Contact information associated with this account.

Example: {"registrant":{"firstName":"Jane","lastName":"Doe","address1":"123 Main St.","city":"Denver","state":"CO","zip":"12345","country":"US","phone":"+1.3035551212","email":"admin@example.net"}}
account.​createDatestring(date-time)

CreateDate is the date the account was created.

Example: "2023-04-01T12:00:00Z"
account.​passwordstring(password)>= 7 characters

Password has minimum length of 7 characters. It must contain at least 1 letter and at least 1 number/symbol.

Example: "SecureP4ss!"
apiTosboolean(ApiTos indicates accepted API Terms of Service agreement)required

Must be set to true to indicate acceptance of the API Terms of Service.

Example: true
tosboolean(Tos indicates accepted Terms of Service agreement)required

Must be set to true to indicate acceptance of the general Terms of Service.

Example: true
curl -i -X POST \
  -u <username>:<password> \
  https://docs.name.com/_mock/coreapi/namecom.api/core/v1/accounts \
  -H 'Content-Type: application/json' \
  -d '{
    "account": {
      "accountName": "reseller_subaccount",
      "password": "SecureP4ss!",
      "contacts": {
        "registrant": {
          "firstName": "Jane",
          "lastName": "Doe",
          "address1": "123 Main St.",
          "city": "Denver",
          "state": "CO",
          "zip": "12345",
          "country": "US",
          "phone": "+1.3035551212",
          "email": "admin@example.net"
        }
      }
    },
    "apiTos": true,
    "tos": true
  }'

Responses

A successful response containing the newly created account details and credentials.

Bodyapplication/json
accountNamestringrequired

AccountName is the unique user-assigned name of newly created account.

Example: "new_reseller_account"
apiTokenstring(password)(ApiToken secret hash to make api requests)required

The authentication token that should be used to access the API. This value is only returned once upon account creation.

Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
apiTokenNamestringrequired

ApiTokenName user assigned name of api token.

Example: "my_reseller_token"
Response
application/json
{
  "accountName": "new_reseller_account",
  "apiToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "apiTokenName": "my_reseller_token"
}

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