{
"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": "The server received an invalid response from the upstream server."
}
{
"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
Check Availability
Checks whether up to 50 domain names are purchasable and returns discovery pricing for each result.
Discovery endpoint: Returns SearchResult fields — purchaseType, purchasePrice, premium, purchasable. Search returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on Create Domain.
When results show premium: true or a non-registrationpurchaseType, follow the Domain pricing guide before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change.
Recommendation: Set purchaseType to registration. Most resellers
restrict results to domains with a purchaseType of registration
to ensure predictable pricing and immediate fulfillment. Other purchase types
(such as aftermarket variants) can introduce higher costs and non-instant
transactions that may be delayed or declined by third parties.
{
"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": "The server received an invalid response from the upstream server."
}
{
"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
AvailabilityRequest is used to list the domain names to check availability for.
Checks if one or more domain names are available for registration (up to 50 domains). Important: Do not encode the : in the path. Use /core/v1/domains:checkAvailability, not /core/v1/domains%3AcheckAvailability.
Optional filter. Recommended:registration for most integrations — omit only if you support acquisition types. Non-matching domains are returned with purchasable: false (Search omits them instead). See the Domain purchase pricing guide.
Results of the search are returned here, the order should not be relied upon.
Show child attributes
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/check-availability","slug":"/api/v1/reference/domains/check-availability","pageMetadata":{"openapi":"post /core/v1/domains:checkAvailability","title":"Check Availability","description":"Checks whether up to 50 domain names are purchasable and returns **discovery** pricing for each result.\n\n**Discovery endpoint:** Returns `SearchResult` fields — `purchaseType`, `purchasePrice`, `premium`, `purchasable`. [Search](/api/v1/reference/domains/search) returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on [Create Domain](/api/v1/reference/domains/create-domain).\n\nWhen results show `premium: true` or a non-`registration` `purchaseType`, follow the [Domain pricing guide](/guides/domain-pricing) before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change.\n\n**Recommendation:** Set `purchaseType` to `registration`. Most resellers \nrestrict results to domains with a `purchaseType` of `registration`\nto ensure predictable pricing and immediate fulfillment. Other purchase types\n(such as aftermarket variants) can introduce higher costs and non-instant\ntransactions that may be delayed or declined by third parties.\n","href":"/api/v1/reference/domains/check-availability"},"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: [\"Checks whether up to 50 domain names are purchasable and returns \", _jsx(_components.strong, {\n children: \"discovery\"\n }), \" pricing for each result.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Discovery endpoint:\"\n }), \" Returns \", _jsx(_components.code, {\n children: \"SearchResult\"\n }), \" fields — \", _jsx(_components.code, {\n children: \"purchaseType\"\n }), \", \", _jsx(_components.code, {\n children: \"purchasePrice\"\n }), \", \", _jsx(_components.code, {\n children: \"premium\"\n }), \", \", _jsx(_components.code, {\n children: \"purchasable\"\n }), \". \", _jsx(_components.a, {\n href: \"/api/v1/reference/domains/search\",\n children: \"Search\"\n }), \" returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on \", _jsx(_components.a, {\n href: \"/api/v1/reference/domains/create-domain\",\n children: \"Create Domain\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"When results show \", _jsx(_components.code, {\n children: \"premium: true\"\n }), \" or a non-\", _jsx(_components.code, {\n children: \"registration\"\n }), \" \", _jsx(_components.code, {\n children: \"purchaseType\"\n }), \", follow the \", _jsx(_components.a, {\n href: \"/guides/domain-pricing\",\n children: \"Domain pricing guide\"\n }), \" before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Recommendation:\"\n }), \" Set \", _jsx(_components.code, {\n children: \"purchaseType\"\n }), \" to \", _jsx(_components.code, {\n children: \"registration\"\n }), \". Most resellers\\nrestrict results to domains with a \", _jsx(_components.code, {\n children: \"purchaseType\"\n }), \" of \", _jsx(_components.code, {\n children: \"registration\"\n }), \"\\nto ensure predictable pricing and immediate fulfillment. Other purchase types\\n(such as aftermarket variants) can introduce higher costs and non-instant\\ntransactions that may be delayed or declined by third parties.\"]\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/domains:checkAvailability","title":"Check Availability","description":"Checks whether up to 50 domain names are purchasable and returns **discovery** pricing for each result.\n\n**Discovery endpoint:** Returns `SearchResult` fields — `purchaseType`, `purchasePrice`, `premium`, `purchasable`. [Search](/api/v1/reference/domains/search) returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on [Create Domain](/api/v1/reference/domains/create-domain).\n\nWhen results show `premium: true` or a non-`registration` `purchaseType`, follow the [Domain pricing guide](/guides/domain-pricing) before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change.\n\n**Recommendation:** Set `purchaseType` to `registration`. Most resellers \nrestrict results to domains with a `purchaseType` of `registration`\nto ensure predictable pricing and immediate fulfillment. Other purchase types\n(such as aftermarket variants) can introduce higher costs and non-instant\ntransactions that may be delayed or declined by third parties.\n","href":"/api/v1/reference/domains/check-availability"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Checks whether up to 50 domain names are purchasable and returns **discovery** pricing for each result.\n\n**Discovery endpoint:** Returns `SearchResult` fields — `purchaseType`, `purchasePrice`, `premium`, `purchasable`. [Search](/api/v1/reference/domains/search) returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on [Create Domain](/api/v1/reference/domains/create-domain).\n\nWhen results show `premium: true` or a non-`registration` `purchaseType`, follow the [Domain pricing guide](/guides/domain-pricing) before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change.\n\n**Recommendation:** Set `purchaseType` to `registration`. Most resellers \nrestrict results to domains with a `purchaseType` of `registration`\nto ensure predictable pricing and immediate fulfillment. Other purchase types\n(such as aftermarket variants) can introduce higher costs and non-instant\ntransactions that may be delayed or declined by third parties.\n","operationId":"CheckAvailability","requestBody":"528b875a-0c8c-40d7-8c0f-fb0a371c34a6","responses":{"200":"a47ef6e1-6a78-4136-9f70-10bfee4a33b4","401":"1d3b7db9-02d3-410b-8002-0288cb9b8885","403":"0f71c205-822b-4388-ad88-0097150cfcd0","405":"bea985a1-1d08-4c11-be01-d4c36cd9e06c","415":"3857906b-d3cf-4e0d-b169-68a341eddc8a","422":"fbc46db9-df5f-46d7-b5b5-322981baf292","429":"8d05e74f-cec4-4207-b39f-f8501455ef73","500":"864641bd-7f1b-46b6-8d11-7701ca710e5b","502":"02591e1a-880c-4c92-a38d-1bb233e82e7a","503":"27bb2061-f560-4c05-9b82-c6ba02e3364d","504":"3fd709d6-219c-4fca-a55f-da20f07d7b7b"},"summary":"Check Availability","tags":["Domains"],"method":"post","type":"path","servers":["a299706b-162f-4709-8731-1da4aafad643"],"security":["d8600753-25c5-4f15-8e86-e3efcdef3502"],"path":"/core/v1/domains:checkAvailability","baseUrlOptions":["https://api.dev.name.com"],"title":"Check Availability","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"description":"Checks if one or more domain names are available for registration (up to 50 domains). Important: Do not encode the `:` in the path. Use `/core/v1/domains:checkAvailability`, not `/core/v1/domains%3AcheckAvailability`.","properties":{"domainNames":{"description":"DomainNames is the list of domains to check if they are available.","items":{"type":"string","minLength":1,"uniqueKey":"domainNames.items.[INDEX]","typeLabel":"string"},"type":"array","maxItems":50,"minItems":1,"isRequired":true,"uniqueKey":"domainNames","typeLabel":"string[]"},"purchaseType":{"type":"string","description":"Optional filter. **Recommended:** `registration` for most integrations — omit only if you support acquisition types. Non-matching domains are returned with `purchasable: false` (Search omits them instead). See the [Domain purchase pricing guide](/guides/domain-pricing).","enum":["registration","aftermarket_i","expiring","backorder","aftermarket_s","aftermarket_b"],"uniqueKey":"purchaseType","typeLabel":"enum\u003cstring>"}},"type":"object","required":["domainNames"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"domainNames":["\u003cstring>"]}}},"exampleType":"generated"}},"description":"AvailabilityRequest is used to list the domain names to check availability for.","required":true,"exampleType":"generated"},"responses":{"a47ef6e1-6a78-4136-9f70-10bfee4a33b4":{"content":{"application/json":{"schema":{"description":"SearchResponse returns a list of search results.","properties":{"results":{"description":"Results of the search are returned here, the order should not be relied upon.","items":{"description":"SearchResult is returned by the CheckAvailability and Search endpoints.","properties":{"domainName":{"description":"DomainName is the punycode encoding of the result domain name.","type":"string","example":"example.com","isRequired":true,"uniqueKey":"results.items.[INDEX].domainName","typeLabel":"string"},"purchasable":{"description":"Purchasable indicates whether the search result is available for purchase.","type":"boolean","example":true,"isRequired":true,"uniqueKey":"results.items.[INDEX].purchasable","typeLabel":"boolean"},"sld":{"description":"SLD is first portion of the domain_name.","type":"string","example":"example","isRequired":true,"uniqueKey":"results.items.[INDEX].sld","typeLabel":"string"},"tld":{"description":"TLD is the rest of the domain_name after the SLD.","type":"string","example":"com","isRequired":true,"uniqueKey":"results.items.[INDEX].tld","typeLabel":"string"},"premium":{"description":"Premium indicates whether this discovery result has premium or non-standard pricing. Only returned for purchasable domains. When `true` with `purchaseType: registration` → registry premium (use [Get Pricing](/api/v1/reference/domains/get-pricing-for-domain) for multi-year totals). When `true` with aftermarket, expiring, or backorder `purchaseType` values → flat acquisition fee (use discovery `purchasePrice`; `years` on create does not multiply price or guarantee registration length). When `true`, `purchasePrice` must be passed on Create Domain.","type":"boolean","example":true,"uniqueKey":"results.items.[INDEX].premium","typeLabel":"boolean"},"purchasePrice":{"description":"PurchasePrice is the minimum-term list or flat acquisition price from discovery, in USD. Only returned for purchasable domains. For `purchaseType: registration` when `purchasePrice` is required on create, use [Get Pricing](/api/v1/reference/domains/get-pricing-for-domain) with matching `years` instead. For aftermarket, expiring, and backorder types, pass this flat acquisition fee on Create Domain — not affected by `years`. Get Pricing does not return these acquisition prices. Recommended to re-check with Check Availability immediately before create for all types — prices can change.","format":"double","type":"number","example":10.99,"uniqueKey":"results.items.[INDEX].purchasePrice","typeLabel":"number\u003cdouble>"},"purchaseType":{"type":"string","description":"PurchaseType indicates what kind of purchase this discovery result is for. Only returned for purchasable domains. Pass to Create Domain as `purchaseType`. See [SearchPurchaseType](#/components/schemas/SearchPurchaseType) for pricing behavior per value. When `premium: true` or the type is not `registration`, follow the [Domain pricing guide](/guides/domain-pricing).","enum":["registration","aftermarket_i","expiring","backorder","aftermarket_s","aftermarket_b"],"uniqueKey":"results.items.[INDEX].purchaseType","typeLabel":"enum\u003cstring>"},"renewalPrice":{"description":"RenewalPrice is the minimum-term renewal total for this domain (typically 1 year; varies by TLD). Only returned for purchasable domains. Informational for standard [Renew Domain](/api/v1/reference/domains/renew-domain) flows — do **not** use to calculate Create Domain `purchasePrice` or multi-year create totals. For premium renewals, use `renewalPrice` from [Get Pricing](/api/v1/reference/domains/get-pricing-for-domain) with matching `years`, not this discovery value.","format":"double","type":"number","example":10.99,"uniqueKey":"results.items.[INDEX].renewalPrice","typeLabel":"number\u003cdouble>"},"reason":{"description":"Reason provides additional context when unavailable (e.g. registry is in maintenance).","type":"string","uniqueKey":"results.items.[INDEX].reason","typeLabel":"string"}},"type":"object","required":["domainName","sld","tld","purchasable"],"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"results","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"domainName":"example.com","purchasable":true,"sld":"example","tld":"com","premium":true,"purchasePrice":10.99,"purchaseType":"registration","renewalPrice":10.99,"reason":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"A successful response.","exampleType":"generated"},"1d3b7db9-02d3-410b-8002-0288cb9b8885":{"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"},"0f71c205-822b-4388-ad88-0097150cfcd0":{"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"},"bea985a1-1d08-4c11-be01-d4c36cd9e06c":{"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"},"3857906b-d3cf-4e0d-b169-68a341eddc8a":{"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"},"fbc46db9-df5f-46d7-b5b5-322981baf292":{"description":"The request was well-formed but contains no valid domains to check. This occurs when all provided domain names contain TLDs that are not supported or available for registration. The request must contain at least one domain with a valid TLD.","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"},"8d05e74f-cec4-4207-b39f-f8501455ef73":{"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"},"864641bd-7f1b-46b6-8d11-7701ca710e5b":{"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"},"02591e1a-880c-4c92-a38d-1bb233e82e7a":{"description":"Bad Gateway","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 server received an invalid response from the upstream server.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The server received an invalid response from the upstream server."}}},"exampleType":"generated"}},"exampleType":"generated"},"27bb2061-f560-4c05-9b82-c6ba02e3364d":{"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"},"3fd709d6-219c-4fca-a55f-da20f07d7b7b":{"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":"Check Availability - name.com Core API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-12T18:12:14.938Z","originalFileLocation":"api/v1/reference/domains/check-availability.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=\"Checks whether up to 50 domain names are purchasable and returns discovery pricing for each result. Discovery endpoint: Returns SearchResult fields — purchaseType, purchasePrice, premium, purchasable. Search returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on Create Domain. When results show premium: true or a non-registration purchaseType, follow the Domain pricing guide before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change. Recommendation: Set purchaseType to registration. Most resellers restrict results to domains with a purchaseType of registration to ensure predictable pricing and immediate fulfillment. Other purchase types (such as aftermarket variants) can introduce higher costs and non-instant transactions that may be delayed or declined by third parties.\">\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=\"Check Availability - name.com Core API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Checks whether up to 50 domain names are purchasable and returns discovery pricing for each result. Discovery endpoint: Returns SearchResult fields — purchaseType, purchasePrice, premium, purchasable. Search returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on Create Domain. When results show premium: true or a non-registration purchaseType, follow the Domain pricing guide before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change. Recommendation: Set purchaseType to registration. Most resellers restrict results to domains with a purchaseType of registration to ensure predictable pricing and immediate fulfillment. Other purchase types (such as aftermarket variants) can introduce higher costs and non-instant transactions that may be delayed or declined by third parties.\">\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/check-availability\">\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=Check+Availability\u0026amp;description=Checks+whether+up+to+50+domain+names+are+purchasable+and+returns+**discovery**+pricing+for+each+result.%0A%0A**Discovery+endpoint%3A**+Returns+%60SearchResult%60+fields+%E2%80%94\u0026amp;theme=a954cb13cd71ba157cb20fc0\u0026amp;signature=0bd948647521656900f78a74c02fde1d888ccf2bb503ba1e41285feb32b26980\">\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=\"Check Availability - name.com Core API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Checks whether up to 50 domain names are purchasable and returns discovery pricing for each result. Discovery endpoint: Returns SearchResult fields — purchaseType, purchasePrice, premium, purchasable. Search returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on Create Domain. When results show premium: true or a non-registration purchaseType, follow the Domain pricing guide before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change. Recommendation: Set purchaseType to registration. Most resellers restrict results to domains with a purchaseType of registration to ensure predictable pricing and immediate fulfillment. Other purchase types (such as aftermarket variants) can introduce higher costs and non-instant transactions that may be delayed or declined by third parties.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://namecom.mintlify.app/_mintlify/api/og/v2?division=Domains\u0026amp;title=Check+Availability\u0026amp;description=Checks+whether+up+to+50+domain+names+are+purchasable+and+returns+**discovery**+pricing+for+each+result.%0A%0A**Discovery+endpoint%3A**+Returns+%60SearchResult%60+fields+%E2%80%94\u0026amp;theme=a954cb13cd71ba157cb20fc0\u0026amp;signature=0bd948647521656900f78a74c02fde1d888ccf2bb503ba1e41285feb32b26980\">\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/check-availability\">\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/check-availability.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/check-availability#webpage\",\"url\":\"https://docs.name.com/api/v1/reference/domains/check-availability\",\"name\":\"Check Availability\",\"description\":\"Checks whether up to 50 domain names are purchasable and returns discovery pricing for each result. Discovery endpoint: Returns SearchResult fields — purchaseType, purchasePrice, premium, purchasable. Search returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on Create Domain. When results show premium: true or a non-registration purchaseType, follow the Domain pricing guide before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change. Recommendation: Set purchaseType to registration. Most resellers restrict results to domains with a purchaseType of registration to ensure predictable pricing and immediate fulfillment. Other purchase types (such as aftermarket variants) can introduce higher costs and non-instant transactions that may be delayed or declined by third parties.\",\"dateModified\":\"2026-06-12T18:12:14.938Z\",\"isPartOf\":{\"@id\":\"https://docs.name.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.name.com/api/v1/reference/domains/check-availability#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.name.com/api/v1/reference/domains/check-availability#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\":\"Check Availability\",\"item\":\"https://docs.name.com/api/v1/reference/domains/check-availability\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.name.com/api/v1/reference/domains/check-availability#apireference\",\"headline\":\"Check Availability\",\"name\":\"Check Availability\",\"description\":\"Checks whether up to 50 domain names are purchasable and returns discovery pricing for each result. Discovery endpoint: Returns SearchResult fields — purchaseType, purchasePrice, premium, purchasable. Search returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on Create Domain. When results show premium: true or a non-registration purchaseType, follow the Domain pricing guide before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change. Recommendation: Set purchaseType to registration. Most resellers restrict results to domains with a purchaseType of registration to ensure predictable pricing and immediate fulfillment. Other purchase types (such as aftermarket variants) can introduce higher costs and non-instant transactions that may be delayed or declined by third parties.\",\"url\":\"https://docs.name.com/api/v1/reference/domains/check-availability\",\"mainEntityOfPage\":{\"@id\":\"https://docs.name.com/api/v1/reference/domains/check-availability#webpage\"},\"dateModified\":\"2026-06-12T18:12:14.938Z\",\"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","description":"SetNameservers will set the nameservers for the Domain. This operation updates the DNS configuration by changing which nameservers are responsible for the domain's zone.","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","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":"Check Availability - 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"]}