{
 "openapi": "3.1.0",
 "info": {
  "title": "Stake API",
  "version": "1.0.0",
  "description": "Stake checks whether domain names are available to register by asking each ending's own registry (RDAP, the official successor to WHOIS). Check full domains or names across .com, .io, .ai, .dev, .app and more, and see who holds the taken ones, since when, until when, and whether they sit on a…",
  "contact": {
   "name": "Clawhard Studio",
   "url": "https://clawhard.com",
   "email": "support@clawhard.com"
  }
 },
 "servers": [
  {
   "url": "https://stake.clawhard.com"
  }
 ],
 "paths": {
  "/api/v1/check_domains": {
   "post": {
    "operationId": "check_domains",
    "summary": "Check whether domain names are available to register (live registry lookup)",
    "description": "Use when the user asks whether a domain is available or taken, wants product, startup, app or project name ideas with a free domain, or is about to put a domain into a plan, README, config or launch post (signals: \"is the .com taken\", \"domain available\", \"name ideas with a .com\", \"which of these…",
    "x-full-description": "Use when the user asks whether a domain is available or taken, wants product, startup, app or project name ideas with a free domain, or is about to put a domain into a plan, README, config or launch post (signals: \"is the .com taken\", \"domain available\", \"name ideas with a .com\", \"which of these names has a free domain\", \".io or .ai\", \"who owns this domain\", \"when does it expire\"). Asks each ending's own registry through RDAP (the official successor to WHOIS; IANA's server list plus the registries of .io, .me, .sh, .ac, .us, .so, .de, .ch that are not in it), and returns per domain: available, registered, registered_expiring (redemption or pending delete), likely_available (DNS only: for endings with no public RDAP such as .co, .gg, .eu, .it, or when a registry's RDAP server refuses or rate-limits the check), unknown or invalid; for taken names the registration and expiry dates, days to expiry, registrar, status codes and nameservers, and a flag when the nameservers belong to a parking or domain-marketplace service (Afternic, Dan.com, Sedo, Atom and others: the owner may sell it). Pass full domains, or names plus endings: {\"names\":[\"tidewell\",\"brightloop\"],\"tlds\":[\"com\",\"io\",\"ai\"]} or {\"domains\":[\"tidewell.com\",\"münchen.de\",\"foo.co.uk\"]}. Default endings when only names are given: com, io, ai, dev, app, co, net, org. Up to 20 domains per call. Call it before presenting name ideas as available instead of guessing. Cannot see prices, premium or reserved status, trademarks, or social handles; \"available\" is not a reservation. Returns: {summary, counts:{available, likely_available, registered, registered_expiring, unknown, invalid}, results:[{domain, unicode?, input, input_note?, tld, status: available|likely_available|registered|registered_dns|registered_expiring|unknown|invalid, available: true|false|null, source:{method: rdap|dns, server, dns?, note?}, registration?:{created, expires, updated, days_to_expiry, age_years, registrar:{name, iana_id}, status_codes, nameservers, parked?:{service, note}}, flags:[text], error?, summary}], notes, sources, checked_at, engine, open_url}",
    "x-openai-isConsequential": false,
    "responses": {
     "200": {
      "description": "Result. Always has \"ok\": true.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "ok": {
           "type": "boolean"
          }
         },
         "additionalProperties": true
        }
       }
      }
     },
     "400": {
      "description": "Bad input. {\"ok\":false,\"error\":\"...\"}"
     },
     "429": {
      "description": "Rate limited. Retry after the Retry-After header."
     }
    },
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "domains": {
          "type": "array",
          "minItems": 1,
          "maxItems": 20,
          "description": "Full domain names to check, e.g. [\"tidewell.com\", \"tidewell.io\"]. International names (münchen.de) and suffixes such as co.uk are fine; a URL or subdomain is reduced to the registrable domain. Up to 20.",
          "items": {
           "type": "string",
           "minLength": 1,
           "maxLength": 260
          }
         },
         "names": {
          "type": "array",
          "minItems": 1,
          "maxItems": 10,
          "description": "Bare names without an ending, e.g. [\"tidewell\"]; each is checked with every entry in tlds. Up to 10 names (and 20 domains in total).",
          "items": {
           "type": "string",
           "minLength": 1,
           "maxLength": 63
          }
         },
         "tlds": {
          "type": "array",
          "minItems": 1,
          "maxItems": 12,
          "description": "Endings to try with names, e.g. [\"com\",\"io\",\"ai\",\"dev\"] (a leading dot is fine; co.uk works). Default: com, io, ai, dev, app, co, net, org.",
          "items": {
           "type": "string",
           "minLength": 1,
           "maxLength": 30
          }
         }
        }
       }
      }
     }
    }
   }
  }
 },
 "externalDocs": {
  "description": "llms.txt",
  "url": "https://stake.clawhard.com/llms.txt"
 }
}