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-item 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. Searching for aftermarket domains is not currently supported.
POST /v1/domains/bulk-search
Checks availability and pricing for a bulk list of up to 50 domain names at a time. Bulk searching for aftermarket domains is not currently supported.
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.
PUT /v1/dns/{domain_name}/nameservers
Replaces the nameservers for a domain. Accepts 2–13 nameserver hostnames. Returns 200 if the nameservers are already configured as requested, or 202 if the change has been submitted and is pending registry processing. Glue records are not supported via the API. Requires the dns_write scope. See DNS Record and Name Server Management: API Write Endpoints for full details.
GET /v1/dns/{domain_name}/records
Retrieves all DNS records for a domain (if using 101domain managed nameservers or Secure Web Accelerator (SWA) nameservers), filterable by record type (A, CNAME, TXT, etc.) and hostname. Every record includes a unique id used for edits and deletions.
POST /v1/dns/{domain_name}/records
Creates up to 25 DNS records in a single request. Supported types: A, AAAA, CNAME, NS (subdomain delegations only), MX, TXT, SRV, and CAA. Returns 201 if records were created, or 200 if all submitted records already existed. Requires the dns_write scope. See DNS Record and Name Server Management: API Write Endpoints for full details.
PATCH /v1/dns/{domain_name}/records
Edits up to 25 existing DNS records by their id. Send only the fields you want to change. A record's id changes when its content is modified — use the new id returned in the response for subsequent operations. Requires the dns_write scope. See DNS Record and Name Server Management: API Write Endpoints for full details.
DELETE /v1/dns/{domain_name}/records
Deletes up to 25 DNS records by their id in a single atomic request. If any id is not found, no records are deleted. Requires the dns_write scope. See DNS Record and Name Server Management: API Write Endpoints for full details.
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.