{
"message": "The 'Content-Type' header must be 'application/json' for this request."
}
{
"message": "Unprocessable Entity",
"details": "The pricing information required to process this request is temporarily unavailable. This is an internal system error. Please try again in a few minutes or contact support if the issue persists."
}
{
"message": "Rate Limit Exceeded"
}
{
"message": "Internal Server Error",
"details": "Something went wrong."
}
{
"message": "Registry Connection Unavailable"
}
{
"message": "Service Unavailable",
"details": "The API is offline for scheduled maintenance. See https://status.name.com for updates."
}
{
"message": "The upstream server is taking too long to respond."
}
Domains
Zone Check
Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain’s availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard Check Availability call.
The API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are removed from the request before the zone file lookup runs. The response includes only a numeric count of removed domains (removed); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains.
For the best results and to avoid 400 Bad Request errors after cleaning, ensure each domain string meets the criteria described for domainNames in the request body schema.
If no valid domains remain after this process, the API returns a 400 Bad Request response.
Note: The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.
{
"message": "The 'Content-Type' header must be 'application/json' for this request."
}
{
"message": "Unprocessable Entity",
"details": "The pricing information required to process this request is temporarily unavailable. This is an internal system error. Please try again in a few minutes or contact support if the issue persists."
}
{
"message": "Rate Limit Exceeded"
}
{
"message": "Internal Server Error",
"details": "Something went wrong."
}
{
"message": "Registry Connection Unavailable"
}
{
"message": "Service Unavailable",
"details": "The API is offline for scheduled maintenance. See https://status.name.com for updates."
}
{
"message": "The upstream server is taking too long to respond."
}
Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.
Body
application/json
Request body to check for availability
ZoneCheck request checks DNS zone files for the availability of the specified domains.
Array of domain names to check. Each entry is normalized and validated before zone check runs. Entries that are not valid domain strings, that use unsupported TLDs for this service, or that fail other pre-validation rules are omitted from the check; the response removed field reports how many were omitted (not which values).
Valid domain string (after normalization) — for reliable results and to avoid errors once all entries are removed:
Allowed characters: ASCII letters (a–z), digits (0–9), and hyphens (-).
Hyphen rules: A domain (the part between dots) must not start or end with a hyphen (for example, -test.com and test-.com are invalid).
Domain length: Each domain must be between 1 and 63 characters.
Internationalized domains (IDNs): Non-ASCII characters (for example ö or ñ) should be submitted as Punycode (xn--...) for consistent registry resolution.
Required array length: 1 - 500 elements
Minimum string length: 1
Examples:
["example.com", "example.net", "example.org"]
["test.net"]
Response
Successful response for a DNS zone check.
Response for checking domain availability via DNS zone checks.
Number of domain strings removed during pre-validation (invalid format, unsupported TLD for this service, etc.). This is a count only; the response does not list which strings were removed.
Example:
1
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"name.com Core API","colors":{"primary":"#1EAA50","dark":"#6EDA78"},"logo":{"light":"https://namedotcom-cdn.name.tools/media/logo/name_logo.svg","dark":"https://namedotcom-cdn.name.tools/media/logo/name_logo-white.svg","href":"https://www.name.com"},"favicon":"https://mintcdn.com/namecom/1rmHLXcBmhL0Pefk/favicon.svg?fit=max\u0026auto=format\u0026n=1rmHLXcBmhL0Pefk\u0026q=85\u0026s=e6f65c5c71b5abe116a4673dca9c256a","api":{"playground":{}},"appearance":{"default":"dark"},"seo":{"metatags":{"google-site-verification":"f-XFmxTzeRzcOF9-ocrS8hNiAemBYY4jDUL5xJwuC9M"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"namecom","hasAudioNarration":false,"actualSubdomain":"namecom","customDomains":["docs.name.com"],"gitSource":{"type":"github","owner":"namedotcom","repo":"coreapi","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ace6015aae446d0f8f844d6","collectionId":"ac21103e-fe0b-4a86-b7ac-6bf690a461c9","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ace6015aae446d0f8f844d6"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ace6015aae446d0f8f844d6","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Core API Reference","count":84},{"language":"default","tag":"Domains","count":19},{"language":"default","tag":"Guides \u0026 Flows","count":18},{"language":"default","tag":"Webhook Notifications","count":16},{"language":"default","tag":"URL Forwardings","count":9},{"language":"default","tag":"Transfers","count":7},{"language":"default","tag":"Operations \u0026 Compliance","count":6},{"language":"default","tag":"DNS","count":5},{"language":"default","tag":"Email Forwardings","count":5},{"language":"default","tag":"External","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/v1/reference/domains/zone-check","slug":"/api/v1/reference/domains/zone-check","pageMetadata":{"openapi":"post /core/v1/zonecheck","title":"Zone Check","description":"Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain's availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard [Check Availability](/api/v1/reference/domains/check-availability) call.\nThe API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are **removed** from the request before the zone file lookup runs. The response includes **only** a numeric count of removed domains (`removed`); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains.\n\nFor the best results and to avoid `400 Bad Request` errors after cleaning, ensure each domain string meets the criteria described for `domainNames` in the request body schema.\n\nIf no valid domains remain after this process, the API returns a `400 Bad Request` response.\n**Note:** The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.","href":"/api/v1/reference/domains/zone-check"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain’s availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard \", _jsx(_components.a, {\n href: \"/api/v1/reference/domains/check-availability\",\n children: \"Check Availability\"\n }), \" call.\\nThe API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are \", _jsx(_components.strong, {\n children: \"removed\"\n }), \" from the request before the zone file lookup runs. The response includes \", _jsx(_components.strong, {\n children: \"only\"\n }), \" a numeric count of removed domains (\", _jsx(_components.code, {\n children: \"removed\"\n }), \"); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"For the best results and to avoid \", _jsx(_components.code, {\n children: \"400 Bad Request\"\n }), \" errors after cleaning, ensure each domain string meets the criteria described for \", _jsx(_components.code, {\n children: \"domainNames\"\n }), \" in the request body schema.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"If no valid domains remain after this process, the API returns a \", _jsx(_components.code, {\n children: \"400 Bad Request\"\n }), \" response.\\n\", _jsx(_components.strong, {\n children: \"Note:\"\n }), \" The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /core/v1/zonecheck","title":"Zone Check","description":"Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain's availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard [Check Availability](/api/v1/reference/domains/check-availability) call.\nThe API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are **removed** from the request before the zone file lookup runs. The response includes **only** a numeric count of removed domains (`removed`); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains.\n\nFor the best results and to avoid `400 Bad Request` errors after cleaning, ensure each domain string meets the criteria described for `domainNames` in the request body schema.\n\nIf no valid domains remain after this process, the API returns a `400 Bad Request` response.\n**Note:** The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.","href":"/api/v1/reference/domains/zone-check"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain's availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard [Check Availability](/api/v1/reference/domains/check-availability) call.\nThe API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are **removed** from the request before the zone file lookup runs. The response includes **only** a numeric count of removed domains (`removed`); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains.\n\nFor the best results and to avoid `400 Bad Request` errors after cleaning, ensure each domain string meets the criteria described for `domainNames` in the request body schema.\n\nIf no valid domains remain after this process, the API returns a `400 Bad Request` response.\n**Note:** The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.","operationId":"ZoneCheck","summary":"Zone Check","tags":["Domains"],"requestBody":"d55b9289-6e23-45fc-a81b-c0f31678bc0f","responses":{"200":"60d623b0-fe15-4e72-978d-9918a88a8994","400":"16a1ea64-934e-4115-b88a-2f13652ed6b7","401":"25c2c27a-5860-47a3-8256-22d05eb6a869","403":"ba1e497c-4b06-4857-ad60-874f7cc1143c","405":"0b5eb368-04dd-4dd1-a6fd-01eada213a9e","415":"e67f3afe-7ecc-4845-8649-e50c8be52053","422":"bc7b3b05-cfd6-4711-ac38-4bf66d766b50","429":"ef60da3b-d6b3-497b-9c89-d0aed1a91b4c","500":"37f3f4ab-2d13-422f-a725-dd96e7aece8a","502":"ae752ac8-36c1-47ad-95d6-91b1fd297cf3","503":"db33c35c-d7c0-4c87-b14b-66feab3943b0","504":"55f78725-da1c-4ee8-9ba0-dfb6fb3ff838"},"method":"post","type":"path","servers":["a299706b-162f-4709-8731-1da4aafad643"],"security":["d8600753-25c5-4f15-8e86-e3efcdef3502"],"path":"/core/v1/zonecheck","baseUrlOptions":["https://api.dev.name.com"],"title":"Zone Check","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"description":"ZoneCheck request checks DNS zone files for the availability of the specified domains.","type":"object","properties":{"domainNames":{"description":"Array of domain names to check. Each entry is normalized and validated before zone check runs. Entries that are not valid domain strings, that use unsupported TLDs for this service, or that fail other pre-validation rules are omitted from the check; the response `removed` field reports how many were omitted (not which values).\n\n**Valid domain string (after normalization)** — for reliable results and to avoid errors once all entries are removed:\n\n- **Allowed characters:** ASCII letters (`a`–`z`), digits (`0`–`9`), and hyphens (`-`).\n\n- **Hyphen rules:** A domain (the part between dots) must not start or end with a hyphen (for example, `-test.com` and `test-.com` are invalid).\n\n- **Domain length:** Each domain must be between 1 and 63 characters.\n\n- **Internationalized domains (IDNs):** Non-ASCII characters (for example `ö` or `ñ`) should be submitted as Punycode (`xn--...`) for consistent registry resolution.","type":"array","items":{"type":"string","minLength":1,"uniqueKey":"domainNames.items.[INDEX]","typeLabel":"string"},"minItems":1,"maxItems":500,"examples":[["example.com","example.net","example.org"],["test.net"]],"isRequired":true,"uniqueKey":"domainNames","typeLabel":"string[]"}},"required":["domainNames"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"domainNames":["example.com","example.net","example.org"]}}},"exampleType":"generated"}},"description":"Request body to check for availability","required":true,"exampleType":"generated"},"responses":{"60d623b0-fe15-4e72-978d-9918a88a8994":{"content":{"application/json":{"schema":{"description":"Response for checking domain availability via DNS zone checks.","type":"object","properties":{"results":{"type":"array","items":{"description":"Result for checking and individual domain's presense in DNS zone files.","type":"object","properties":{"domainName":{"description":"The domain name that was checked","type":"string","example":"example.com","isRequired":true,"uniqueKey":"results.items.[INDEX].domainName","typeLabel":"string"},"available":{"oneOf":[{"description":"If the domain is potentially available for purchase after checking for it's presense in the DNZ zone files.","type":"boolean","examples":[true,false,null],"isRequired":true,"uniqueKey":"results.items.[INDEX].available.oneOf.0","typeLabel":"boolean"},{"description":"If the domain is potentially available for purchase after checking for it's presense in the DNZ zone files.","type":"null","examples":[true,false,null],"isRequired":true,"uniqueKey":"results.items.[INDEX].available.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].available","typeLabel":"boolean | null"}},"required":["domainName","available"],"minLength":0,"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"total":{"description":"Total number of records checked","type":"integer","format":"int32","example":5,"isRequired":true,"uniqueKey":"total","typeLabel":"integer\u003cint32>"},"removed":{"description":"Number of domain strings removed during pre-validation (invalid format, unsupported TLD for this service, etc.). This is a count only; the response does not list which strings were removed.","type":"integer","format":"int32","example":1,"uniqueKey":"removed","typeLabel":"integer\u003cint32>"}},"required":["results","total"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"domainName":"example.com","available":true}],"total":5,"removed":1}}},"exampleType":"generated"}},"description":"Successful response for a DNS zone check.","exampleType":"generated"},"16a1ea64-934e-4115-b88a-2f13652ed6b7":{"description":"Bad request - Invalid input data.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Bad Request","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error","example":"'domainName' cannot be null","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error","example":"'domainName' cannot be null","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Bad Request","details":"'domainName' cannot be null"}}},"exampleType":"generated"}},"exampleType":"generated"},"25c2c27a-5860-47a3-8256-22d05eb6a869":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Unauthorized","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"ba1e497c-4b06-4857-ad60-874f7cc1143c":{"description":"Forbidden - you do not have permission to perform this action.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Permission denied","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error","example":"Failed authentication","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error","example":"Failed authentication","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Permission denied","details":"Failed authentication"}}},"exampleType":"generated"}},"exampleType":"generated"},"0b5eb368-04dd-4dd1-a6fd-01eada213a9e":{"description":"Method not allowed.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Method Not Allowed","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Method Not Allowed"}}},"exampleType":"generated"}},"exampleType":"generated"},"e67f3afe-7ecc-4845-8649-e50c8be52053":{"description":"All POST, PUT, PATCH requests for this API must include the `Content-Type: application/json` header in the requests.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"The 'Content-Type' header must be 'application/json' for this request.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The 'Content-Type' header must be 'application/json' for this request."}}},"exampleType":"generated"}},"exampleType":"generated"},"bc7b3b05-cfd6-4711-ac38-4bf66d766b50":{"description":"Returned when, after cleaning, there were no valid domains passed in the request.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Unprocessable Entity","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"string","description":"Additional context or information about the pricing error","example":"The pricing information required to process this request is temporarily unavailable. This is an internal system error. Please try again in a few minutes or contact support if the issue persists.","uniqueKey":"details","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Unprocessable Entity","details":"The pricing information required to process this request is temporarily unavailable. This is an internal system error. Please try again in a few minutes or contact support if the issue persists."}}},"exampleType":"generated"}},"exampleType":"generated"},"ef60da3b-d6b3-497b-9c89-d0aed1a91b4c":{"description":"Rate limit has been exceeded.","content":{"application/json":{"schema":{"type":"object","required":["message","details"],"properties":{"message":{"type":"string","description":"### Too Many Requests\nYou have exceeded the rate limit.\n\n**Headers returned:**\n* 'X-RateLimit-Reset': An integer (UTC epoch) indicating when you can retry.","example":"Rate Limit Exceeded","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Rate Limit Exceeded"}}},"exampleType":"generated"}},"headers":{"x-ratelimit-reset":{"description":"Unix timestamp for the time at which the current rate limit will reset.","schema":{"type":"number","example":1747668270}}},"exampleType":"generated"},"37f3f4ab-2d13-422f-a725-dd96e7aece8a":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","example":"Internal Server Error","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error.","example":"Something went wrong.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error.","example":"Something went wrong.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Internal Server Error","details":"Something went wrong."}}},"exampleType":"generated"}},"exampleType":"generated"},"ae752ac8-36c1-47ad-95d6-91b1fd297cf3":{"description":"There was a temporary error in processing the request. The request can be retried immediately.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Registry Connection Unavailable","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Registry Connection Unavailable"}}},"exampleType":"generated"}},"exampleType":"generated"},"db33c35c-d7c0-4c87-b14b-66feab3943b0":{"description":"Service Unavailable — returned during scheduled maintenance when the API is offline. See https://status.name.com for updates.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","example":"Service Unavailable","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error.","example":"The API is offline for scheduled maintenance. See https://status.name.com for updates.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error.","example":"The API is offline for scheduled maintenance. See https://status.name.com for updates.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Service Unavailable","details":"The API is offline for scheduled maintenance. See https://status.name.com for updates."}}},"exampleType":"generated"}},"exampleType":"generated"},"55f78725-da1c-4ee8-9ba0-dfb6fb3ff838":{"description":"Gateway Timeout","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","example":"The upstream server is taking too long to respond.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The upstream server is taking too long to respond."}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d8600753-25c5-4f15-8e86-e3efcdef3502":{"BasicAuth":{"scheme":"basic","type":"http","description":"Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic \u003cbase64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append \"-test\" to your username and use your sandbox token on api.dev.name.com.","scopes":[],"schemeName":"BasicAuth"}}},"servers":{"a299706b-162f-4709-8731-1da4aafad643":{"description":"Testing","url":"https://api.dev.name.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"basic","type":"http","description":"Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic \u003cbase64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append \"-test\" to your username and use your sandbox token on api.dev.name.com.","scopes":[],"schemeName":"BasicAuth"},"schema":{"title":"Basic Auth","type":"object","description":"Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic \u003cbase64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append \"-test\" to your username and use your sandbox token on api.dev.name.com.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"BasicAuth","name":"Authorization"}],"title":"BasicAuth"}]},"originalFileLocation":"api/v1/namecom.api.yaml"},"subdomain":"namecom","siteName":"name.com Core API","title":"Zone Check - name.com Core API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-12T18:12:14.999Z","originalFileLocation":"api/v1/reference/domains/zone-check.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain\u0026#x27;s availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard Check Availability call. The API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are removed from the request before the zone file lookup runs. The response includes only a numeric count of removed domains (removed); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains. For the best results and to avoid 400 Bad Request errors after cleaning, ensure each domain string meets the criteria described for domainNames in the request body schema. If no valid domains remain after this process, the API returns a 400 Bad Request response. Note: The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.\">\u003cmeta data-mint-head name=\"application-name\" content=\"name.com Core API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Zone Check - name.com Core API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain\u0026#x27;s availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard Check Availability call. The API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are removed from the request before the zone file lookup runs. The response includes only a numeric count of removed domains (removed); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains. For the best results and to avoid 400 Bad Request errors after cleaning, ensure each domain string meets the criteria described for domainNames in the request body schema. If no valid domains remain after this process, the API returns a 400 Bad Request response. Note: The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"name.com Core API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.name.com/api/v1/reference/domains/zone-check\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://namecom.mintlify.app/_mintlify/api/og/v2?division=Domains\u0026amp;title=Zone+Check\u0026amp;description=Zone+Check+offers+a+rapid%2C+preliminary+check+for+domain+availability+by+leveraging+cached+zone+file+data.++Ideal+for+large-batch+queries%2C+it+provides+a+high+con\u0026amp;theme=a954cb13cd71ba157cb20fc0\u0026amp;signature=e127e8cc0e83a6b7b183e86e499e792661ee4dfc4f464ddc7e4882a5c1199bb7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Zone Check - name.com Core API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain\u0026#x27;s availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard Check Availability call. The API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are removed from the request before the zone file lookup runs. The response includes only a numeric count of removed domains (removed); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains. For the best results and to avoid 400 Bad Request errors after cleaning, ensure each domain string meets the criteria described for domainNames in the request body schema. If no valid domains remain after this process, the API returns a 400 Bad Request response. Note: The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://namecom.mintlify.app/_mintlify/api/og/v2?division=Domains\u0026amp;title=Zone+Check\u0026amp;description=Zone+Check+offers+a+rapid%2C+preliminary+check+for+domain+availability+by+leveraging+cached+zone+file+data.++Ideal+for+large-batch+queries%2C+it+provides+a+high+con\u0026amp;theme=a954cb13cd71ba157cb20fc0\u0026amp;signature=e127e8cc0e83a6b7b183e86e499e792661ee4dfc4f464ddc7e4882a5c1199bb7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/namecom/YtIhkLytNOiNFb-Q/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"name.com Core API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1EAA50\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"f-XFmxTzeRzcOF9-ocrS8hNiAemBYY4jDUL5xJwuC9M\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.name.com/api/v1/reference/domains/zone-check\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/v1/reference/domains/zone-check.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.name.com/#organization\",\"name\":\"name.com Core API\",\"url\":\"https://docs.name.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://namedotcom-cdn.name.tools/media/logo/name_logo.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.name.com#website\",\"name\":\"name.com Core API\",\"url\":\"https://docs.name.com\",\"publisher\":{\"@id\":\"https://docs.name.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.name.com/api/v1/reference/domains/zone-check#webpage\",\"url\":\"https://docs.name.com/api/v1/reference/domains/zone-check\",\"name\":\"Zone Check\",\"description\":\"Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain's availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard Check Availability call. The API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are removed from the request before the zone file lookup runs. The response includes only a numeric count of removed domains (removed); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains. For the best results and to avoid 400 Bad Request errors after cleaning, ensure each domain string meets the criteria described for domainNames in the request body schema. If no valid domains remain after this process, the API returns a 400 Bad Request response. Note: The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.\",\"dateModified\":\"2026-06-12T18:12:14.999Z\",\"isPartOf\":{\"@id\":\"https://docs.name.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.name.com/api/v1/reference/domains/zone-check#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.name.com/api/v1/reference/domains/zone-check#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core API Reference\",\"item\":\"https://docs.name.com/api/v1/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Domains\",\"item\":\"https://docs.name.com/api/v1/reference/domains/list-domains\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Zone Check\",\"item\":\"https://docs.name.com/api/v1/reference/domains/zone-check\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.name.com/api/v1/reference/domains/zone-check#apireference\",\"headline\":\"Zone Check\",\"name\":\"Zone Check\",\"description\":\"Zone Check offers a rapid, preliminary check for domain availability by leveraging cached zone file data. Ideal for large-batch queries, it provides a high confidence indication of a domain's availability significantly faster than live registry checks. For definitive, real-time availability and pricing, you can follow up with the standard Check Availability call. The API normalizes and validates each submitted domain string. Domains that fail validation, use an unsupported TLD for this service, or are otherwise not eligible for zone check are removed from the request before the zone file lookup runs. The response includes only a numeric count of removed domains (removed); individual removed strings are not returned. A future API version may extend the contract to include details about removed domains. For the best results and to avoid 400 Bad Request errors after cleaning, ensure each domain string meets the criteria described for domainNames in the request body schema. If no valid domains remain after this process, the API returns a 400 Bad Request response. Note: The cached zone files used for this check are refreshed twice daily based on the latest available data from the registries.\",\"url\":\"https://docs.name.com/api/v1/reference/domains/zone-check\",\"mainEntityOfPage\":{\"@id\":\"https://docs.name.com/api/v1/reference/domains/zone-check#webpage\"},\"dateModified\":\"2026-06-12T18:12:14.999Z\",\"publisher\":{\"@id\":\"https://docs.name.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.name.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"name.com Core API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"name.com Core API","nav":{"global":null,"groups":[{"group":"API Home","pages":[{"title":"name.com Core API Documentation","href":"/index"}]},{"group":"Guides \u0026 Flows","pages":[{"title":"v4 to CORE API Migration","href":"/guides/migration-guide"},{"group":"Setup","pages":[{"title":"Authentication","href":"/guides/authentication"},{"title":"Getting Started","href":"/guides/getting-started"},{"title":"Testing Environment","href":"/guides/testing-environment"}]},{"group":"Build \u0026 Launch","pages":[{"title":"Reseller Quickstart","href":"/guides/quickstart"},{"title":"Domain Purchase Pricing","href":"/guides/domain-pricing"},{"title":"Quickstart TLD List","href":"/guides/quickstart-recommended-tlds"}]},{"group":"Operations \u0026 Compliance","pages":[{"title":"Contact Verification Compliance","href":"/guides/contact-verification"},{"title":"Domain Renewals \u0026 Expiration","href":"/guides/domain-renewals-expiration"},{"title":"Funding Your name.com Account","href":"/guides/funding-your-namecom-account"},{"title":"HMAC Signature Verification","href":"/guides/hmac-examples"},{"title":"Registrant Communications","href":"/guides/registrant-communications"},{"title":"Understanding Domain Locks","href":"/guides/domain-locks"}]},{"group":"Flows","pages":[{"title":"Claims Flow","href":"/guides/claims-flow"},{"title":"External Transfers Flow","href":"/guides/external-transfers-flow"},{"title":"Refunds Flow","href":"/guides/refunds-flow"}]},{"group":"MCP Integrations","pages":[{"title":"API Docs MCP","href":"/integrations/mcp/api-docs-mcp"},{"title":"name.com MCP","href":"/integrations/mcp/namecom-mcp"}]}]},{"group":"Official SDKs","tag":"NEW","pages":[{"title":"SDK Quickstart","href":"/sdks/index"}]},{"group":"Core API Reference","pages":[{"title":"API Overview","href":"/api/v1/overview"},{"group":"Hello","pages":[{"openapi":"get /core/v1/hello","title":"Hello","href":"/api/v1/reference/hello/hello"}]},{"group":"Account Info","pages":[{"openapi":"get /core/v1/accountinfo/balance","title":"Check Account Balance","href":"/api/v1/reference/account-info/check-account-balance"}]},{"group":"Contact Verification","pages":[{"openapi":"get /core/v1/contacts/unverified","title":"List Unverified Contacts","href":"/api/v1/reference/contact-verification/list-unverified-contacts"},{"openapi":"post /core/v1/contacts/verify/{verificationId}","title":"Verify Contact","href":"/api/v1/reference/contact-verification/verify-contact"},{"openapi":"post /core/v1/contacts/verify/{verificationId}:resend","title":"Resend Contact Verification Email","href":"/api/v1/reference/contact-verification/resend-verification-email"}]},{"group":"Domains","pages":[{"openapi":"get /core/v1/domains","title":"List Domains","href":"/api/v1/reference/domains/list-domains"},{"openapi":"post /core/v1/domains","title":"Create Domain","href":"/api/v1/reference/domains/create-domain"},{"openapi":"get /core/v1/domains/{domainName}","title":"Get Domain","href":"/api/v1/reference/domains/get-domain"},{"openapi":"patch /core/v1/domains/{domainName}","title":"Update a domain","href":"/api/v1/reference/domains/update-a-domain"},{"openapi":"get /core/v1/domains/{domainName}:getAuthCode","title":"Get Auth Code For Domain","href":"/api/v1/reference/domains/get-auth-code-for-domain"},{"openapi":"get /core/v1/domains/{domainName}:getPricing","title":"Get Pricing For Domain","href":"/api/v1/reference/domains/get-pricing-for-domain"},{"openapi":"post /core/v1/domains/{domainName}:purchasePrivacy","title":"Purchase Privacy","href":"/api/v1/reference/domains/purchase-privacy"},{"openapi":"post /core/v1/domains/{domainName}:renew","title":"Renew Domain","href":"/api/v1/reference/domains/renew-domain"},{"openapi":"post /core/v1/domains/{domainName}:setContacts","title":"Set Contacts","href":"/api/v1/reference/domains/set-contacts"},{"openapi":"post /core/v1/domains/{domainName}:setNameservers","title":"Set Nameservers","href":"/api/v1/reference/domains/set-nameservers"},{"openapi":"post /core/v1/domains:checkAvailability","title":"Check Availability","href":"/api/v1/reference/domains/check-availability"},{"openapi":"post /core/v1/domains:search","title":"Search","description":"Searches for domain name suggestions based on a keyword or term. Important: Do not\nencode the `:` in the path. Use `/core/v1/domains:search`, not `/core/v1/domains%3Asearch`.\n\n**Discovery endpoint:** Returns `SearchResult` fields — `purchaseType`, `purchasePrice`, `premium`, `purchasable`.\n\n**Recommendation:** Set `purchaseType` to `registration`. Most resellers restrict\nresults to domains with a `purchaseType` of `registration` to ensure predictable\npricing and immediate fulfillment. Other purchase types (such as aftermarket) can\nintroduce higher costs and non-instant transactions that may be delayed or declined\nby third parties.\nWith `purchaseType: registration`, domains that do not match the filter are **omitted** from results (unlike Check Availability, which returns them with `purchasable: false`).\n\nWhen results show `premium: true` or a non-`registration` `purchaseType`, follow the [Domain pricing guide](/guides/domain-pricing) before calling Create Domain. For all types, re-check with Check Availability immediately before create — prices and availability can change.\n","href":"/api/v1/reference/domains/search"},{"openapi":"post /core/v1/zonecheck","title":"Zone Check","href":"/api/v1/reference/domains/zone-check"},{"openapi":"post /core/v1/domains/{domainName}:disableAutorenew","deprecated":true,"title":"Disable Autorenew","description":"Turns off automatic renewal for a domain. **DEPRECATED** This endpoint is deprecated in favor of the new UpdateDomain API. This will be removed in a future release.","href":"/api/v1/reference/domains/disable-autorenew"},{"openapi":"post /core/v1/domains/{domainName}:disableWhoisPrivacy","deprecated":true,"title":"Disable Whois Privacy","href":"/api/v1/reference/domains/disable-whois-privacy"},{"openapi":"post /core/v1/domains/{domainName}:enableAutorenew","deprecated":true,"title":"Enable Autorenew","href":"/api/v1/reference/domains/enable-autorenew"},{"openapi":"post /core/v1/domains/{domainName}:enableWhoisPrivacy","deprecated":true,"title":"Enable Whois Privacy","href":"/api/v1/reference/domains/enable-whois-privacy"},{"openapi":"post /core/v1/domains/{domainName}:lock","deprecated":true,"title":"Lock Domain","href":"/api/v1/reference/domains/lock-domain"},{"openapi":"post /core/v1/domains/{domainName}:unlock","deprecated":true,"title":"Unlock Domain","href":"/api/v1/reference/domains/unlock-domain"}]},{"group":"Domain Info","pages":[{"openapi":"get /core/v1/domaininfo/requirementsV2/{tld}","title":"Get TLD Requirements as JSON Schema","href":"/api/v1/reference/domain-info/get-specific-tld-requirements-v2"},{"openapi":"get /core/v1/domaininfo/requirements/{tld}","title":"Get Specific TLD Requirements","href":"/api/v1/reference/domain-info/get-specific-tld-requirements"},{"openapi":"post /core/v1/domaininfo/claims/{domain}","title":"Check Domain Claims","href":"/api/v1/reference/domain-info/check-domain-claims"}]},{"group":"DNS","pages":[{"openapi":"get /core/v1/domains/{domainName}/records","title":"List Records","href":"/api/v1/reference/dns/list-records"},{"openapi":"post /core/v1/domains/{domainName}/records","title":"Create Record","href":"/api/v1/reference/dns/create-record"},{"openapi":"get /core/v1/domains/{domainName}/records/{id}","title":"Get Record","href":"/api/v1/reference/dns/get-record"},{"openapi":"put /core/v1/domains/{domainName}/records/{id}","title":"Update Record","href":"/api/v1/reference/dns/update-record"},{"openapi":"delete /core/v1/domains/{domainName}/records/{id}","title":"Delete Record","href":"/api/v1/reference/dns/delete-record"}]},{"group":"DNSSECs","pages":[{"openapi":"get /core/v1/domains/{domainName}/dnssec","title":"List DNSSECs","href":"/api/v1/reference/dnssecs/list-dnssecs"},{"openapi":"post /core/v1/domains/{domainName}/dnssec","title":"Create DNSSEC","href":"/api/v1/reference/dnssecs/create-dnssec"},{"openapi":"get /core/v1/domains/{domainName}/dnssec/{digest}","title":"Get DNSSEC","href":"/api/v1/reference/dnssecs/get-dnssec"},{"openapi":"delete /core/v1/domains/{domainName}/dnssec/{digest}","title":"Delete DNSSEC","href":"/api/v1/reference/dnssecs/delete-dnssec"}]},{"group":"Email Forwardings","pages":[{"openapi":"get /core/v1/domains/{domainName}/email/forwarding","title":"List Email Forwardings","href":"/api/v1/reference/email-forwardings/list-email-forwardings"},{"openapi":"post /core/v1/domains/{domainName}/email/forwarding","title":"Create Email Forwarding","href":"/api/v1/reference/email-forwardings/create-email-forwarding"},{"openapi":"get /core/v1/domains/{domainName}/email/forwarding/{emailBox}","title":"Get Email Forwarding","href":"/api/v1/reference/email-forwardings/get-email-forwarding"},{"openapi":"put /core/v1/domains/{domainName}/email/forwarding/{emailBox}","title":"Update Email Forwarding","href":"/api/v1/reference/email-forwardings/update-email-forwarding"},{"openapi":"delete /core/v1/domains/{domainName}/email/forwarding/{emailBox}","title":"Delete Email Forwarding","href":"/api/v1/reference/email-forwardings/delete-email-forwarding"}]},{"group":"Orders","pages":[{"openapi":"get /core/v1/orders","title":"List Orders","href":"/api/v1/reference/orders/list-orders"},{"openapi":"get /core/v1/orders/{orderId}","title":"Get Order","href":"/api/v1/reference/orders/get-order"}]},{"group":"Refunds","pages":[{"openapi":"post /core/v1/refund","title":"Process Refund","href":"/api/v1/reference/refunds/process-refund"}]},{"group":"Premium Domains","pages":[{"openapi":"get /core/v1/premiumdomainslist","title":"Download Premium Domain Lists","href":"/api/v1/reference/premium-domains/download-premium-domain-lists"}]},{"group":"TLD Pricing","pages":[{"openapi":"get /core/v1/tldpricing","title":"TLD Price List","href":"/api/v1/reference/tld-pricing/tld-price-list"}]},{"group":"Transfers","pages":[{"title":"Check Transfer Eligibility","openapi":"get /core/v1/transfers/eligibility/{domainName}","href":"/api/v1/reference/transfers/get-transfer-eligibility"},{"group":"External","pages":[{"title":"List Transfers","openapi":"get /core/v1/transfers","href":"/api/v1/reference/transfers/list-transfers"},{"title":"Get Transfer Status","openapi":"get /core/v1/transfers/{domainName}","href":"/api/v1/reference/transfers/get-transfer"},{"title":"Create External Transfer In","openapi":"post /core/v1/transfers","href":"/api/v1/reference/transfers/create-transfer"},{"title":"Cancel External Transfer In","openapi":"post /core/v1/transfers/{domainName}:cancel","href":"/api/v1/reference/transfers/cancel-transfer"},{"title":"Cancel External Transfer Out","openapi":"post /core/v1/transfers/external/out/{domainName}:cancel","href":"/api/v1/reference/transfers/cancel-external-transfer-out"}]},{"group":"Internal","pages":[{"title":"Create Internal Transfer In","openapi":"post /core/v1/transfers/internal/in","href":"/api/v1/reference/transfers/create-internal-transfer-in"}]}]},{"group":"URL Forwardings","pages":[{"openapi":"post /core/v1/domains/{domainName}/url/forwarding","title":"Create URLForwarding","href":"/api/v1/reference/url-forwardings/create-urlforwarding"},{"openapi":"get /core/v1/urlforwarding/{domainName}","title":"List URL Forwardings by domain","href":"/api/v1/reference/url-forwardings/list-urlforwardings-by-domain"},{"openapi":"get /core/v1/urlforwarding/{domainName}/{id}","title":"Get URL Forwarding by ID","href":"/api/v1/reference/url-forwardings/get-urlforwarding-by-id"},{"openapi":"patch /core/v1/urlforwarding/{domainName}/{id}","title":"Update URL Forwarding by ID","href":"/api/v1/reference/url-forwardings/update-urlforwarding-by-id"},{"openapi":"delete /core/v1/urlforwarding/{domainName}/{id}","title":"Delete URL Forwarding by ID","href":"/api/v1/reference/url-forwardings/delete-urlforwarding-by-id"},{"openapi":"get /core/v1/domains/{domainName}/url/forwarding","deprecated":true,"title":"List URLForwardings","href":"/api/v1/reference/url-forwardings/list-urlforwardings"},{"openapi":"get /core/v1/domains/{domainName}/url/forwarding/{host}","deprecated":true,"title":"Get URLForwarding","href":"/api/v1/reference/url-forwardings/get-urlforwarding"},{"openapi":"put /core/v1/domains/{domainName}/url/forwarding/{host}","deprecated":true,"title":"Update URLForwarding","href":"/api/v1/reference/url-forwardings/update-urlforwarding"},{"openapi":"delete /core/v1/domains/{domainName}/url/forwarding/{host}","deprecated":true,"title":"Delete URLForwarding","href":"/api/v1/reference/url-forwardings/delete-urlforwarding"}]},{"group":"Vanity Nameservers","pages":[{"openapi":"get /core/v1/domains/{domainName}/vanity_nameservers","title":"List Vanity Nameservers","href":"/api/v1/reference/vanity-nameservers/list-vanity-nameservers"},{"openapi":"post /core/v1/domains/{domainName}/vanity_nameservers","title":"Create Vanity Nameserver","href":"/api/v1/reference/vanity-nameservers/create-vanity-nameserver"},{"openapi":"get /core/v1/domains/{domainName}/vanity_nameservers/{hostname}","title":"Get Vanity Nameserver","href":"/api/v1/reference/vanity-nameservers/get-vanity-nameserver"},{"openapi":"put /core/v1/domains/{domainName}/vanity_nameservers/{hostname}","title":"Update Vanity Nameserver IP","href":"/api/v1/reference/vanity-nameservers/update-vanity-nameserver-ip"},{"openapi":"delete /core/v1/domains/{domainName}/vanity_nameservers/{hostname}","title":"Delete Vanity Nameserver","href":"/api/v1/reference/vanity-nameservers/delete-vanity-nameserver"}]},{"group":"Webhook Notifications","pages":[{"title":"Webhooks Overview","href":"/api/v1/reference/webhook-notifications/overview"},{"group":"Subscriptions","pages":[{"title":"Get Subscribed Notifications","openapi":"get /core/v1/notifications","href":"/api/v1/reference/webhook-notifications/get-subscribed-notifications"},{"title":"Subscribe to Notification","openapi":"post /core/v1/notifications","href":"/api/v1/reference/webhook-notifications/subscribe-to-notification"},{"title":"Modify Subscription","openapi":"put /core/v1/notifications/{id}","href":"/api/v1/reference/webhook-notifications/modify-subscription"},{"title":"Delete Subscription","openapi":"delete /core/v1/notifications/{id}","href":"/api/v1/reference/webhook-notifications/delete-subscription"}]},{"group":"Account Events","pages":[{"title":"Account Credit Balance Change","openapi":"webhook accountCreditBalanceChange","href":"/api/v1/reference/webhook-notifications/account-credit-balance-change"}]},{"group":"Contact Events","pages":[{"title":"Contact Verification Status Change","openapi":"webhook contactVerificationStatusChange","href":"/api/v1/reference/webhook-notifications/contact-verification-status-change"}]},{"group":"Domain Events","pages":[{"title":"Domain Expiration","openapi":"webhook domainExpiration","href":"/api/v1/reference/webhook-notifications/domain-expiration"},{"title":"Domain Lock Status Change","openapi":"webhook domainLockStatusChange","href":"/api/v1/reference/webhook-notifications/domain-lock-status-change"},{"title":"Domain Registry Compliance Notice","openapi":"webhook domainRegistryComplianceNotice","href":"/api/v1/reference/webhook-notifications/domain-registry-compliance-notice"},{"title":"Domain Registry Rejection","openapi":"webhook domainRegistryRejection","href":"/api/v1/reference/webhook-notifications/domain-registry-rejection"},{"title":"Domain Removal","openapi":"webhook accountDomainRemoval","href":"/api/v1/reference/webhook-notifications/account-domain-removal"}]},{"group":"Transfers — External","pages":[{"title":"Domain Transfer In Status Change","openapi":"webhook domainTransferStatusChange","href":"/api/v1/reference/webhook-notifications/domain-transfer-status-change"},{"title":"Domain Transfer Out Status Change","openapi":"webhook domainTransferOutStatusChange","href":"/api/v1/reference/webhook-notifications/domain-transfer-out-status-change"}]},{"group":"Transfers — Internal","pages":[{"title":"Internal Transfer In Status Change","openapi":"webhook domainTransferInternalInStatusChange","href":"/api/v1/reference/webhook-notifications/domain-transfer-internal-in-status-change"},{"title":"Internal Transfer Out Status Change","openapi":"webhook domainTransferInternalOutStatusChange","href":"/api/v1/reference/webhook-notifications/domain-transfer-internal-out-status-change"}]}]}]},{"group":"Resources","pages":[{"title":"FAQ \u0026 Troubleshooting","href":"/resources/faq"},{"title":"Changelog","href":"/api/v1/changelog"}]}]},"basePath":"","title":"Zone Check - name.com Core API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}