namecheap-dns

Use when managing DNS records or domains via Namecheap API — getHosts/setHosts record management, domain registration, transfers, SSL certificates, or WHOIS. Critical — setHosts replaces ALL records, must GET first then SET complete list.

Model	Source
sonnet	pack: dns

Full Reference

┏━ 🔧 namecheap-dns ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Use when managing DNS records or domains via N… ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Namecheap DNS & Domain API

Namecheap XML API (February 2026). All requests are HTTP GET with query string params. Responses are XML — no JSON. IPv4 whitelist required for all requests. setHosts replaces the entire record set — always GET first, then SET the complete modified list.

Quick Reference

Item	Value
Base URL (production)	https://api.namecheap.com/xml.response
Base URL (sandbox)	https://api.sandbox.namecheap.com/xml.response
Format	HTTP GET, XML responses
Auth	4 global query params on every request
IP whitelist	IPv4 only — enable at Profile → Tools → API Access
Rate limit	~20 req/min soft limit
Docs	https://www.namecheap.com/support/api/intro/

Reference Index

I want to…	File
Authenticate and set up credentials	reference/auth.md
Manage DNS records with getHosts and setHosts	reference/records.md
Manage domains, transfers, SSL, and WhoisGuard	reference/domains.md
Handle errors and rate limits	reference/errors-and-limits.md

Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.