API Reference

Complete reference documentation for the DomainKit API.

Base URL

https://api.domainkit.bot

Endpoints

Endpoint Method Description
/check GET Check domain availability
/tlds GET List supported TLDs
/register GET Get registration links
/health GET API health check

Request Format

All endpoints accept query parameters:

curl "https://api.domainkit.bot/check?name=example&tld=com"

Response Format

All responses are JSON:

{
  "results": [...],
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2025-01-31T12:00:00Z"
  }
}

Authentication

Most endpoints work without authentication, but authenticated requests get higher rate limits:

curl "https://api.domainkit.bot/check?name=example" \
  -H "Authorization: Bearer YOUR_API_KEY"

See Authentication for details.

Errors

All errors return a consistent format:

{
  "error": "invalid_domain",
  "message": "The domain format is invalid",
  "code": 400
}

See Error Codes for the complete list.

SDKs & Tools

  • MCP Server: /mcp/ — For AI agent integration
  • OpenAPI Spec: /openapi.yaml — Full API specification
  • llms.txt: /llms.txt — Machine-readable overview