DNA Rest API

Everything in this guide, your AI agent can read too. See how

Claude CodeCursorCodexChatGPTClaude

At a glance

• Base URL: https://api.domainresellerapi.com/api/v1/
• Authentication: the X-API-KEY and __reseller headers on every request — see Authentication.
• Format: JSON over HTTPS. There is no SDK to install.
• Test environment: https://ote.domainresellerapi.com with your separate test API key; registry operations are simulated and your balance is not charged.

Your first request

Check whether a domain is available. Replace the two header values with the API key and reseller ID from your reseller panel.

curl -X POST https://api.domainresellerapi.com/api/v1/domains/search \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -H '__reseller: YOUR_RESELLER_ID' \
  -H 'Content-Type: application/json' \
  -d '{"domainName":"apiname.com"}'

Then read Before you write any code: four decisions that prevent most integration bugs.

Find what you need

ContactsThe four contact roles, reusable handle codes, and the e-mail verification that can suspend a domain.

DomainsCheck availability, register, renew, transfer, and manage a domain afterwards.

Name servers & DNSSECWhich name servers answer for a domain, host (glue) records, and DS records.

DNS recordsAdd, change and remove A, MX, TXT, CNAME and other records on our name servers.

SSL certificatesGenerate a CSR, buy, configure, poll for issuance and download — in that order.

HostingBuy and provision shared hosting accounts; creation is asynchronous.

Catalogue & billingWhat you can sell and at what price, your orders, and your balance.

Error codesEvery error code with what it means and what to do — and which ones never to retry.

Your AI agent can build the integration

Claude CodeCursorCodexChatGPTClaude

1. Claude Code reads the whole guide before it writes a line

   /llms-full.txt

2. Cursor writes your registration flow, extra registry fields included

   /domains/register.md

3. Codex fills in the tldAttributes .com.tr asks for

   /tlds/com.tr.md

4. ChatGPT explains an error code and what to do about it

   /reference/errors.md

5. Claude checks your renewal logic against the rules

   /domains/renew.md

Every page of this guide is also plain Markdown, written so a coding agent can follow it as well as you can. Your agent reads the rules, then writes the code that calls the API with your key.

Set up your agent →llms.txt →The whole guide →All endpoints →

Give the guide to your agent

Claude Code

Add this line to CLAUDE.md in your project:

Before working on our DNA Rest API integration, read https://www.domainnameapi.com/docs/llms.txt and fetch the pages it lists that you need.

Codex

Add this line to AGENTS.md in your project:

Before working on our DNA Rest API integration, read https://www.domainnameapi.com/docs/llms.txt and fetch the pages it lists that you need.

Cursor

Add this line to AGENTS.md in your project. Cursor reads it in every chat:

Before working on our DNA Rest API integration, read https://www.domainnameapi.com/docs/llms.txt and fetch the pages it lists that you need.

ChatGPT & Claude

Every page has Open in ChatGPT and Open in Claude under its title. To give a chat the whole guide, paste this link:

https://www.domainnameapi.com/docs/llms-full.txt

Questions

Can my agent call the API for me?

Not from this guide alone. It reads the rules and writes code that calls the API with your API key. Run that code against the test environment first: registry operations there are simulated and your balance is not charged.

Does my agent need an API key to read the guide?

No. Every page, /llms.txt and /llms-full.txt are public.

Which file should it read first?

/llms.txt: one line per page, so the agent fetches only what it needs. Every page is also Markdown at its own address plus .md, for example /domains/register.md. If your agent can take a large file in one go, /llms-full.txt is the whole guide, about 300 KB.

How current is it?

The Markdown is built from the same source as these pages, so they never disagree. The TLD pages come from the catalogue on the date shown at the bottom of each one; in your code, read live values from GET /api/v1/products/tlds.

Support

Open a ticket from your reseller panel. Include your X-Correlation-ID and, for paid operations, the traceId from your transaction list.