{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Performs real-time, authoritative availability checks directly against domain\nregistries. Use this endpoint to verify a domain is available before attempting\nregistration via `POST /registrations`.\n\n**Important:** Unlike the Search endpoint, these results are authoritative and\nreflect current registry status. Always check availability immediately before\nregistration as domain status can change rapidly.\n\n**Note:** This endpoint uses POST to accept a list of domains in the request\nbody. It is a read-only operation — it does not create, modify, or reserve\nany domains.\n\n### Extension support\n\nOnly domains on extensions supported for programmatic registration by this API\ncan be registered. If you check a domain on an unsupported extension, the response\nwill include `registrable: false` with a `reason` field explaining why:\n\n- `extension_not_supported_via_api` — Cloudflare Registrar supports this extension\n  in the dashboard, but it is not yet available for programmatic registration via\n  this API. Register via `https://dash.cloudflare.com/{account_id}/domains/registrations` instead.\n- `extension_not_supported` — This extension is not supported by Cloudflare\n  Registrar.\n- `extension_disallows_registration` — The extension's registry has temporarily\n  or permanently frozen new registrations. No registrar can register domains on\n  this extension at this time.\n- `domain_premium` — The domain is premium priced. Premium registration is not\n  currently supported by this API.\n- `domain_unavailable` — The domain is already registered, reserved, or otherwise\n  not available for registration on a supported extension.\n\nThe `reason` field is only present when `registrable` is `false`.\n\n### Behavior\n- Maximum 20 domains per request\n- Pricing is only returned for domains where `registrable: true`\n- Results are not cached; each request queries the registry\n\n### Workflow\n1. Call this endpoint with domains the user wants to register.\n2. For each domain where `registrable: true`, present pricing to the user.\n3. If `tier: premium`, note that premium registration is not currently\n   supported by this API and do not proceed to `POST /registrations`.\n4. Proceed to `POST /registrations` only for supported non-premium domains.\n","properties":{"path":{"type":"object","properties":{"account_id":{"$ref":"#/definitions/registrar-api-sandbox_identifier","description":"Cloudflare account ID. Required for all Registrar API operations."}},"required":["account_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/registrar-api-sandbox_domain_check_request","examples":[{"domains":["myawesomebrand.com","myawesomebrand.net","myawesomebrand.org","myawesomebrand.app","myawesomebrand.dev"]}]}},"required":["path","body"],"additionalProperties":false,"definitions":{"registrar-api-sandbox_identifier":{"description":"Identifier.","type":"string","maxLength":32,"examples":["023e105f4ecef8ad9ca31a8372d0c353"]},"registrar-api-sandbox_domain_check_request":{"description":"Request body for checking domain availability.","type":"object","properties":{"domains":{"description":"List of fully qualified domain names (FQDNs) to check for availability. Each domain must include the extension.\n- Minimum: 1 domain.\n- Maximum: 20 domains per request.\n- The response returns domains on unsupported extensions with `registrable: false` and a `reason` field.\n- The response may omit malformed domain names (e.g., names missing an extension).\n","type":"array","items":{"type":"string"},"maxItems":20,"minItems":1,"examples":[["example.com","example.net"]]}},"required":["domains"]}}},"name":"Check domain availability","id":"cloudflare.sandbox-registrar-domain-discovery-check","example":{"path":{"account_id":"023e105f4ecef8ad9ca31a8372d0c353"},"body":{"domains":["example.com","example.net"]}},"maxRequests":1,"summary":false}}