SDK Quickstart

Official client SDKs for the name.com Core API. They give you typed clients that map directly to the API reference, so you can start building in minutes. Use an SDK when you want the fastest path in your language. Prefer raw HTTP when you want full control — both talk to the same API.

Available packages

Language	Install	Status	Source
TypeScript / Node.js	`npm install @namecom/core-api`	Available	GitHub · npm
Go	`go get github.com/namedotcom/core-api-go`	Available	GitHub
PHP	`composer require namecom/core-api`	Available	GitHub · Packagist
Python	`pip install namecom-core-api`	Coming soon	GitHub

Python (namecom-core-api) is not released yet. Rest assured, it’s coming soon! In the meantime, you can use standard Python libraries like urllib or requests to access the Core API over HTTPS. We will update this page when the package is available.

Environments and auth

SDKs use the same credentials as curl: HTTP Basic Auth with your API username and token. See Authentication and Getting Started.

Environment	Base URL	Username
Sandbox	`https://api.dev.name.com`	`your-username-test` + sandbox token
Production	`https://api.name.com`	`your-username` + production token

Pass the matching base URL (or environment) when you construct the client. Do not mix sandbox credentials with the production host.

First call

Call GET /core/v1/hello to verify install and auth. Examples below use the sandbox.

import { NamecomClient } from "@namecom/core-api";

const client = new NamecomClient({
  username: "your-username-test",
  password: "your-sandbox-token",
  baseUrl: "https://api.dev.name.com",
});

const hello = await client.hello();
console.log(hello.motd);

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/namedotcom/core-api-go/client"
	"github.com/namedotcom/core-api-go/option"
)

func main() {
	c := client.NewNamecom(
		option.WithBaseURL("https://api.dev.name.com"),
		option.WithBasicAuth("your-username-test", "your-sandbox-token"),
	)

	hello, err := c.Hello(context.Background())
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(hello.Motd)
}

<?php

require __DIR__ . '/vendor/autoload.php';

use Namecom\NamecomClient;

$client = new NamecomClient(
    'your-username-test',
    'your-sandbox-token',
    ['baseUrl' => 'https://api.dev.name.com']
);

$hello = $client->hello();
print_r($hello);

# Coming soon
#
# from namecom_core_api import Namecom
#
# client = Namecom(
#     username="your-username-test",
#     password="your-sandbox-token",
#     base_url="https://api.dev.name.com",
# )
# print(client.hello().motd)

Each GitHub repository includes a README with additional language-specific detail. Prefer that README for advanced configuration; use this page for install, auth, and your first request.

Next steps

Reseller Quickstart

Search → register → manage with the Core API

API reference

Full endpoint documentation (same surface as the SDKs)

Testing environment

Sandbox credentials, credit, and limits

name.com MCP

Call the Core API from AI agents

API Home

Guides & Flows

Official SDKs

Core API Reference

Resources

Available packages

Environments and auth

First call

Next steps

Reseller Quickstart

API reference

Testing environment

name.com MCP

​Available packages

​Environments and auth

​First call

​Next steps

Reseller Quickstart

API reference

Testing environment

name.com MCP

Available packages

Environments and auth

First call

Next steps