# ThatMgmt: full reference ThatMgmt: Good code, made easy. Domain, email, hosting, and AI in one bundle: set up the bundle, hire your (AI) agents, prompt things, enjoy. This file is the full reference for the domain side of the bundle and its API. Domain buying works like this: check availability, get a locked quote, fund a unique deposit address with USDC, ETH, or SOL, and own the domain. Domains need no signup and no credit card, and domains are never a subscription. One price per domain, no tiers. Public ids, errors, and docs use neutral naming: no supplier brands anywhere customer-visible. OpenAPI spec: /openapi.json (interactive viewer at /api.html). Docs hub: /docs.html. Platform overview: /platform.html. Domains product: /domains.html. Offerings detail: /offerings.html. Pricing: /pricing.html. ## For AI agents: the purchase flow 1. **Check.** GET https://api.thatmgmt.com/v1/public/availability?domain=example.com: free, no signup. 2. **Quote.** GET https://api.thatmgmt.com/v1/public/quote?domain=example.com&period=1: the locked price (`totalPayableCents` plus a quote fingerprint). The total you see is the total you pay. 3. **Plan (authenticated).** POST /v1/orders/dry-run with the action (domains.register, domains.renew, domains.transfer), domain, and period. Returns itemized pricing, the readiness checklist with machine-readable reason codes, what is still gated, and the next steps. The locked total binds approvals, budget reservation, and spend checks. 4. **Fund.** Every order gets a unique deposit address. Send USDC, ETH, or SOL from any wallet. No card, no bank account, no signup. 5. **Own it.** After approval and funding, orders register, renew, or transfer domains, subject to budget reservations and spend-ceiling checks. MCP server: `npx @thatmgmt/mcp` (npm, official MCP registry). Public availability and quote tools need no key; tenant tools use your API key. Source: https://github.com/Thingscorp/thatmgmt-mcp Real prices: 1-year .com promo $9.80; standard .com $13.01; .com renewal $15.01. Free, always: availability checks, quotes, dry-runs, DNS edits, auto-renew toggles, portfolio reads. Membership tiers (the bundle as one subscription): Founding $29/mo (first 100, locked while subscribed), Membership $39/mo, Annual $390/yr (two months free), same bundle in every tier. ## Offering matrix (offering id -> category) | id | category | covers | key routes | |---|---|---|---| | domains | domains | registration, renewal, transfer with real execution, locked quotes, crypto checkout | GET /v1/domains, /v1/domains/{resourceId}, /v1/domains/availability, /v1/domains/suggestions, /v1/domains/quote, /v1/domains/prepare-registration, POST /v1/orders/dry-run, GET /v1/domains/{resourceId}/dns, POST /v1/domains/{resourceId}/dns/preview | | customer-accounts | customer accounts | per-customer portfolio context derived server-side (reads) | GET /v1/portfolio/context, GET /v1/customers/{customerId}, GET /v1/customers/{customerId}/status, POST /v1/customers/dry-run and POST /v1/customers/{customerId}/dry-run (dry-run plans only) | | certificates | SSL certificates | certificate inventory, expiration/status/renewal risk (reads) | GET /v1/portfolio/certificates, /v1/portfolio/broader-health, /v1/portfolio/exceptions, GET /v1/certificates/{certificateId}/{actions,download,domains/{domainName},domains/{domainName}/control,email-history,site-seal} | | commerce | commerce | store/channel/transaction reads | GET /v1/portfolio/commerce, /v1/portfolio/broader-health, /v1/portfolio/exceptions, GET /v1/subscriptions, /v1/subscriptions/{subscriptionId}, /v1/orders, /v1/orders/{orderId} | | aftermarket | aftermarket domains | aftermarket/auction reads | GET /v1/portfolio/aftermarket, GET /v1/aftermarket/listings?customerId= | | parking | domain parking | parked-domain reads | GET /v1/portfolio/parking | | hosting | hosting | hosting-product reads | GET /v1/portfolio/hosting | | notifications | notifications | portfolio notifications + payload schemas | GET /v1/portfolio/notifications, /v1/portfolio/notifications/schemas/{schemaName}, POST /v1/portfolio/notifications/{notificationId}/acknowledge/dry-run (dry-run plan only) | Entitlement-gated portfolio reads return 409 when entitlement is unverified. A method that is not allowed on a known route returns 405 Method Not Allowed with an `Allow` header naming the permitted methods and a JSON error envelope (`code: "method_not_allowed"`). Authenticated routes share one per-tenant rate budget; when exhausted the route returns 429 with error code `rate_limited` ("Too many requests", retryable) and a `Retry-After` header naming the wait in seconds. Unauthenticated health probes are exempt. ## Execution posture After approval and funding, orders register, renew, or transfer domains. Dry-runs and quotes never move money and never touch the supplier. Every write sits behind approval, budget reservation, and spend-ceiling gates. Errors use a neutral envelope: {code, message, retryable, details}. HTTP, MCP, and CLI share one control plane. Entitlement evidence is caller-supplied; unknown values are reported as "unknown". ## API surface (public + authenticated) GET /health/live GET /health/ready GET /v1/public/availability <- public, no key: is the name free? GET /v1/public/quote <- public, no key: locked total POST /v1/public/orders <- public, no key: start an order, returns a deposit address GET /v1/public/orders/{orderId} <- public, no key: check an order's payment status GET /v1/public/capabilities <- public, no key: inventory of public endpoints GET /v1/aftermarket/listings GET /v1/agreements GET /v1/capabilities <- live discovery endpoint GET /v1/certificates/{certificateId}/actions GET /v1/certificates/{certificateId}/domains/{domainName} GET /v1/certificates/{certificateId}/domains/{domainName}/control GET /v1/certificates/{certificateId}/download GET /v1/certificates/{certificateId}/email-history GET /v1/certificates/{certificateId}/site-seal GET /v1/countries GET /v1/customers/{customerId} GET /v1/customers/{customerId}/status POST /v1/customers/dry-run <- dry-run plan only POST /v1/customers/{customerId}/dry-run <- dry-run plan only GET /v1/domains GET /v1/domains/availability GET /v1/domains/prepare-registration GET /v1/domains/quote GET /v1/domains/suggestions GET /v1/domains/{resourceId} GET /v1/domains/{resourceId}/dns POST /v1/domains/{resourceId}/dns/preview <- dry-run only GET /v1/offerings <- reseller offering coverage matrix GET /v1/operations/{operationId} GET /v1/orders GET /v1/orders/{orderId} POST /v1/orders/dry-run <- order plan: register/renew/transfer pricing, gates, next steps; transfer takes authCodePresent (raw code rejected) GET /v1/portfolio GET /v1/portfolio/actions GET /v1/portfolio/aftermarket GET /v1/portfolio/broader-health GET /v1/portfolio/catalog GET /v1/portfolio/certificates GET /v1/portfolio/commerce GET /v1/portfolio/context GET /v1/portfolio/diagnostics GET /v1/portfolio/exceptions GET /v1/portfolio/health GET /v1/portfolio/hosting GET /v1/portfolio/notifications GET /v1/portfolio/notifications/schemas/{schemaName} POST /v1/portfolio/notifications/{notificationId}/acknowledge/dry-run <- dry-run plan only GET /v1/portfolio/parking GET /v1/portfolio/renewal-risk GET /v1/subscriptions GET /v1/subscriptions/{subscriptionId} POST /v1/webhooks/privy <- deposit webhook receiver (signed; not customer-called)