Understanding API Endpoints
An API Endpoint is a specific digital address (URL) where the 101domain server receives requests to perform a task. Think of it like a specific "service desk" in our system: one desk handles domain searches, while another handles DNS updates. By connecting to these endpoints, your application or AI agent can retrieve information or execute commands automatically.
The reference below catalogs our available service addresses. Each entry defines the Method (e.g., GET, POST), the Path, and a brief description of the action it performs.
We are continuously expanding our API surface area. Please note that endpoints labeled (Coming Soon) are currently in the development phase and will be enabled in a future release.
For detailed information on rate limits and request quotas, please refer to the API Key Limits guide.
Account Balance, Users & Contact Handles
GET /v1/account/balance
Retrieves the current available credit balance, currency type, and amount due for open invoices.
GET /v1/account/users (Coming Soon)
Will provide read-only access to the list of primary user and sub-user accounts.
GET, POST, DELETE /v1/account/contacts (Coming Soon)
Will allow users to read, create, or delete account and domain contacts (deletions are only allowed if contacts are unassociated with active domains).
Orders & Transactions
GET /v1/account/orders & /{ordernumber} (Coming Soon)
Will provide individual or bulk access to order history and line-items details for past orders.
GET /v1/account/invoices & /{invoicenumber} (Coming Soon)
Will provide individual or bulk access to invoice history, status, and line-item details.
GET /v1/account/transactions (Coming Soon)
Will provide individual or bulk access to payment and refund transaction history.
TLDs (Top-Level Domains)
GET /v1/tlds/{tld_name}
Retrieves detailed information for a single TLD, including registration pricing, renewal prices, transfer pricing, available terms, character limits, and specific registration requirements.
POST /v1/tlds/bulk-lookup
Submits up to 50 TLDs at once to fetch detailed TLD information included in the single TLD request.
Domain Search & Registration
GET /v1/domains/search
Checks the availability of a single specified domain name and returns pricing and terms, if available.
POST /v1/domains/bulk-search
Checks availability and pricing for a bulk list of up to 50 domain names at a time.
POST /v1/domains/registration (Coming Soon)
Will allow clients to place an order to register new domains programmatically.
Domain Name Operations
GET /v1/domains/{domain_name}
Retrieves detailed information for a specific domain in your account, including registration/expiration dates, auto-renew status, and more.
GET /v1/domains
Retrieves a paginated list of domains in your portfolio with detailed information. This endpoint supports filtering by search terms, domain status, nameservers, and expiration dates.
PATCH /v1/domains/{domainname} (Coming Soon)
Will allow modification of domain properties like auto-renew status, nameservers, add-ons, or contact handles.
GET, POST, PATCH, DELETE /v1/domains/{domain_name}/forwarding
Manages web forwarding for domains. Users can view, add, modify, or remove 301 or cloaked web forwarding configurations for their domains.
GET, PUT /v1/domains/token/{domainname} (Coming Soon)
Will allow users to retrieve or refresh an authorization (EPP) code for a domain transfer.
DNS Records & Nameservers
GET /v1/dns/{domain_name}/nameservers
Retrieves the current authoritative nameservers for a specific domain managed within the account.
POST, PATCH, DELETE /v1/domains/{domainName}/nameservers (Coming Soon)
Will allow adding, modifying, or deleting nameservers for a domain.
GET /v1/dns/{domain_name}/records
Retrieves all DNS records for a domain (if using 101domain or 101domain-provided Cloudflare nameservers), filterable by record type (A, CNAME, TXT, etc.) and hostname.
POST, PATCH, DELETE /v1/dns/{zoneName}/records (Coming Soon)
Will allow full programmatic management (creation, updating, and deletion) of individual DNS records.
GET, POST, PATCH, DELETE DS Records (Coming Soon)
Will allow management of Delegation Signer (DS) records for DNSSEC configuration.
Products & Add-Ons
GET /v1/products/{product_id}
Retrieves descriptive details and pricing information (new/renew) for specific product IDs (such as domain add-ons).
Groups & Organizations
GET, POST, PATCH, DELETE Groups (Coming Soon)
Will introduce the ability to organize domains into "Groups" or "Business Units" to isolate permissions and portfolios within the Control Panel and via the API & MCP Tools.