Pulls a domain from another name.com account into your reseller (gaining) account using a valid authorization code. This is an internal name.com-to-name.com move; it is separate from Create Transfer, which brings domains in from external registrars.
Check if a TLD is eligible for internal transfer in by calling Tld Requirements for the TLD and checking property supportsInternalTransfer.
This API is only available to approved reseller accounts. Contact name.com support to request access.
Losing account (dashboard only)
The party that holds the domain today must use the name.com dashboard on the losing account to unlock the domain (remove registrar transfer lock) and to copy the authorization code to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account.
Gaining account (this API)
Call this endpoint with domainName, authCode, and optional contacts using the gaining reseller’s API credentials.
Contacts and post-transfer lock
If contacts is omitted, the gaining account’s default contacts are applied. If contacts is provided, any roles included in the request are applied and omitted roles use the gaining account’s default contacts (same pattern as Create Domain and Set Contacts). The 60-day contact-change transfer lock is enforced based on the gaining account’s settings, consistent with Set Contacts.
Access
Restricted to approved enterprise resellers; other callers receive 403 Forbidden.
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 for transferring a domain from another name.com account into the authenticated reseller (gaining) account.
Transfer authorization code (EPP/auth code) for the domain. The losing account holder must obtain this code from the name.com dashboard; it is not exposed by this API for the losing account.
WHOIS contacts to apply after the transfer. If omitted, the gaining account's default contacts are applied. If provided, include any roles to override; omitted roles use the gaining account's default contacts. Each supplied role must include complete contact fields. A registrar contact-change transfer lock may apply according to the gaining account's settings, consistent with the Set Contacts endpoint.
Show child attributes
Response
The domain was accepted into the gaining account. The response body matches the domain resource representation used elsewhere in the API (same shape as Get Domain / Set Contacts).
List of all registry locking statuses currently applied to the domain. Use this to see which locks are active (e.g. clientTransferProhibited, clientHold). Empty when the domain has no locks applied.
When present, the domain has an active ICANN-mandated transfer lock (new registration, transfer-in, or material registrant contact change) that blocks client unlock via the API until this time. When omitted, there is no active policy transfer lock with a known expiry — the domain may still be locked (locked: true) due to a voluntary user lock. Does not represent RegistrarLock, AccountLock, verification holds, trademark-claim locks, or admin TransferLock with no expiry date.
The cost to renew the domain. This may be required for the RenewDomain operation.
Example:
12.99
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.3990","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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/v1/reference/transfers/create-internal-transfer-in","slug":"/api/v1/reference/transfers/create-internal-transfer-in","pageMetadata":{"title":"Create Internal Transfer In","openapi":"post /core/v1/transfers/internal/in","description":"Pulls a domain from another [name.com](https://www.name.com) account into your reseller (gaining) account using a valid authorization code. This is an **internal** name.com-to-name.com move; it is separate from [Create Transfer](/api/v1/reference/transfers/create-transfer), which brings domains in from **external** registrars.\nCheck if a TLD is eligible for internal transfer in by calling [Tld Requirements](/api/v1/reference/domaininfo/requirementsV2) for the TLD and checking property `supportsInternalTransfer`.\nThis API is only available to approved reseller accounts. Contact name.com support to request access.\n#### Losing account (dashboard only)\nThe party that holds the domain today must use the name.com dashboard on the **losing** account to **unlock** the domain (remove registrar transfer lock) and to **copy the authorization code** to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account.\n#### Gaining account (this API)\nCall this endpoint with `domainName`, `authCode`, and optional `contacts` using the **gaining** reseller's API credentials.\n#### Contacts and post-transfer lock\nIf `contacts` is omitted, the gaining account's default contacts are applied. If `contacts` is provided, any roles included in the request are applied and omitted roles use the gaining account's default contacts (same pattern as [Create Domain](/api/v1/reference/domains/create-domain) and [Set Contacts](/api/v1/reference/domains/set-contacts)). The 60-day contact-change transfer lock is enforced based on the **gaining** account's settings, consistent with Set Contacts.\n#### Access\nRestricted to approved enterprise resellers; other callers receive `403 Forbidden`.","href":"/api/v1/reference/transfers/create-internal-transfer-in"},"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 h4: \"h4\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Pulls a domain from another \", _jsx(_components.a, {\n href: \"https://www.name.com\",\n children: \"name.com\"\n }), \" account into your reseller (gaining) account using a valid authorization code. This is an \", _jsx(_components.strong, {\n children: \"internal\"\n }), \" name.com-to-name.com move; it is separate from \", _jsx(_components.a, {\n href: \"/api/v1/reference/transfers/create-transfer\",\n children: \"Create Transfer\"\n }), \", which brings domains in from \", _jsx(_components.strong, {\n children: \"external\"\n }), \" registrars.\\nCheck if a TLD is eligible for internal transfer in by calling \", _jsx(_components.a, {\n href: \"/api/v1/reference/domaininfo/requirementsV2\",\n children: \"Tld Requirements\"\n }), \" for the TLD and checking property \", _jsx(_components.code, {\n children: \"supportsInternalTransfer\"\n }), \".\\nThis API is only available to approved reseller accounts. Contact name.com support to request access.\"]\n }), \"\\n\", _jsx(_components.h4, {\n children: \"Losing account (dashboard only)\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The party that holds the domain today must use the name.com dashboard on the \", _jsx(_components.strong, {\n children: \"losing\"\n }), \" account to \", _jsx(_components.strong, {\n children: \"unlock\"\n }), \" the domain (remove registrar transfer lock) and to \", _jsx(_components.strong, {\n children: \"copy the authorization code\"\n }), \" to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account.\"]\n }), \"\\n\", _jsx(_components.h4, {\n children: \"Gaining account (this API)\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Call this endpoint with \", _jsx(_components.code, {\n children: \"domainName\"\n }), \", \", _jsx(_components.code, {\n children: \"authCode\"\n }), \", and optional \", _jsx(_components.code, {\n children: \"contacts\"\n }), \" using the \", _jsx(_components.strong, {\n children: \"gaining\"\n }), \" reseller’s API credentials.\"]\n }), \"\\n\", _jsx(_components.h4, {\n children: \"Contacts and post-transfer lock\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"If \", _jsx(_components.code, {\n children: \"contacts\"\n }), \" is omitted, the gaining account’s default contacts are applied. If \", _jsx(_components.code, {\n children: \"contacts\"\n }), \" is provided, any roles included in the request are applied and omitted roles use the gaining account’s default contacts (same pattern as \", _jsx(_components.a, {\n href: \"/api/v1/reference/domains/create-domain\",\n children: \"Create Domain\"\n }), \" and \", _jsx(_components.a, {\n href: \"/api/v1/reference/domains/set-contacts\",\n children: \"Set Contacts\"\n }), \"). The 60-day contact-change transfer lock is enforced based on the \", _jsx(_components.strong, {\n children: \"gaining\"\n }), \" account’s settings, consistent with Set Contacts.\"]\n }), \"\\n\", _jsx(_components.h4, {\n children: \"Access\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Restricted to approved enterprise resellers; other callers receive \", _jsx(_components.code, {\n children: \"403 Forbidden\"\n }), \".\"]\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":{"title":"Create Internal Transfer In","openapi":"post /core/v1/transfers/internal/in","description":"Pulls a domain from another [name.com](https://www.name.com) account into your reseller (gaining) account using a valid authorization code. This is an **internal** name.com-to-name.com move; it is separate from [Create Transfer](/api/v1/reference/transfers/create-transfer), which brings domains in from **external** registrars.\nCheck if a TLD is eligible for internal transfer in by calling [Tld Requirements](/api/v1/reference/domaininfo/requirementsV2) for the TLD and checking property `supportsInternalTransfer`.\nThis API is only available to approved reseller accounts. Contact name.com support to request access.\n#### Losing account (dashboard only)\nThe party that holds the domain today must use the name.com dashboard on the **losing** account to **unlock** the domain (remove registrar transfer lock) and to **copy the authorization code** to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account.\n#### Gaining account (this API)\nCall this endpoint with `domainName`, `authCode`, and optional `contacts` using the **gaining** reseller's API credentials.\n#### Contacts and post-transfer lock\nIf `contacts` is omitted, the gaining account's default contacts are applied. If `contacts` is provided, any roles included in the request are applied and omitted roles use the gaining account's default contacts (same pattern as [Create Domain](/api/v1/reference/domains/create-domain) and [Set Contacts](/api/v1/reference/domains/set-contacts)). The 60-day contact-change transfer lock is enforced based on the **gaining** account's settings, consistent with Set Contacts.\n#### Access\nRestricted to approved enterprise resellers; other callers receive `403 Forbidden`.","href":"/api/v1/reference/transfers/create-internal-transfer-in"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Pulls a domain from another [name.com](https://www.name.com) account into your reseller (gaining) account using a valid authorization code. This is an **internal** name.com-to-name.com move; it is separate from [Create Transfer](/api/v1/reference/transfers/create-transfer), which brings domains in from **external** registrars.\nCheck if a TLD is eligible for internal transfer in by calling [Tld Requirements](/api/v1/reference/domaininfo/requirementsV2) for the TLD and checking property `supportsInternalTransfer`.\nThis API is only available to approved reseller accounts. Contact name.com support to request access.\n#### Losing account (dashboard only)\nThe party that holds the domain today must use the name.com dashboard on the **losing** account to **unlock** the domain (remove registrar transfer lock) and to **copy the authorization code** to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account.\n#### Gaining account (this API)\nCall this endpoint with `domainName`, `authCode`, and optional `contacts` using the **gaining** reseller's API credentials.\n#### Contacts and post-transfer lock\nIf `contacts` is omitted, the gaining account's default contacts are applied. If `contacts` is provided, any roles included in the request are applied and omitted roles use the gaining account's default contacts (same pattern as [Create Domain](/api/v1/reference/domains/create-domain) and [Set Contacts](/api/v1/reference/domains/set-contacts)). The 60-day contact-change transfer lock is enforced based on the **gaining** account's settings, consistent with Set Contacts.\n#### Access\nRestricted to approved enterprise resellers; other callers receive `403 Forbidden`.","operationId":"CreateInternalTransferIn","requestBody":"8b63e864-bd66-4362-b367-d2dbdd7411c9","responses":{"200":"93ba034d-5ff7-4b6f-b7b4-d52adfa379b0","400":"59725600-d601-41c3-8b2f-8c7cc4cc5027","401":"7fbf9c67-d853-4c99-89de-550d13b02f44","403":"de8fd99c-eddb-44f9-ba73-3d52aaff5cb9","404":"67387879-1cd2-411f-afe9-cc40535d336f","405":"cd14762d-586d-4c9a-b1ac-7658311a7039","409":"0abb582f-706a-4af5-a7ac-afcb23243ba9","415":"49e09111-ad2a-4b83-b78a-b8769d8d9e72","429":"bc7c6fe0-2fb8-4180-903d-7861d4b3220b","500":"a1d438f8-25d8-439f-bea0-1a782bf39c73","502":"e70d3be4-c471-444d-a592-2e6f097e7d95","503":"1ae5a791-f229-4ab3-820a-0f75131f47f5","504":"17cef1fc-81ea-4bcc-bd85-3e3ec63ceced"},"summary":"Create Internal Transfer In","tags":["Transfers"],"method":"post","type":"path","servers":["a299706b-162f-4709-8731-1da4aafad643"],"security":["d8600753-25c5-4f15-8e86-e3efcdef3502"],"path":"/core/v1/transfers/internal/in","baseUrlOptions":["https://api.dev.name.com"],"title":"Create Internal Transfer In","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"description":"Request body for transferring a domain from another name.com account into the authenticated reseller (gaining) account.","properties":{"domainName":{"description":"Fully qualified domain name to transfer in. The domain must be registered in another name.com account (the losing account).","type":"string","example":"example.com","minLength":1,"isRequired":true,"uniqueKey":"domainName","typeLabel":"string"},"authCode":{"description":"Transfer authorization code (EPP/auth code) for the domain. The losing account holder must obtain this code from the [name.com](https://www.name.com) dashboard; it is not exposed by this API for the losing account.","type":"string","example":"ABC123","minLength":1,"isRequired":true,"uniqueKey":"authCode","typeLabel":"string"},"contacts":{"type":"object","description":"WHOIS contacts to apply after the transfer. If omitted, the gaining account's default contacts are applied. If provided, include any roles to override; omitted roles use the gaining account's default contacts. Each supplied role must include complete contact fields. A registrar contact-change transfer lock may apply according to the gaining account's settings, consistent with the Set Contacts endpoint.","properties":{"admin":{"type":"object","description":"Contact contains all relevant contact data for a domain registrant. This schema is used for creating and updating contacts (POST/PUT requests) and includes all validation requirements. All fields listed in the `required` array must be provided and cannot be null or empty.","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"firstName":{"type":"string","description":"First name of the contact.","minLength":1,"example":"John","isRequired":true,"uniqueKey":"contacts.admin.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name of the contact.","minLength":1,"example":"Doe","isRequired":true,"uniqueKey":"contacts.admin.lastName","typeLabel":"string"},"address1":{"type":"string","description":"The first line of the contact's address.","minLength":1,"example":"123 Main Street","isRequired":true,"uniqueKey":"contacts.admin.address1","typeLabel":"string"},"city":{"type":"string","description":"City of the contact's address.","minLength":1,"example":"New York","isRequired":true,"uniqueKey":"contacts.admin.city","typeLabel":"string"},"state":{"type":"string","description":"State or Province of the contact's address.","minLength":1,"example":"NY","isRequired":true,"uniqueKey":"contacts.admin.state","typeLabel":"string"},"zip":{"type":"string","description":"ZIP or Postal Code of the contact's address. This field is required and must be a non-empty string.","minLength":1,"example":"10001","isRequired":true,"uniqueKey":"contacts.admin.zip","typeLabel":"string"},"country":{"type":"string","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","pattern":"^[A-Z]{2}$","example":"US","isRequired":true,"uniqueKey":"contacts.admin.country","typeLabel":"string"},"email":{"type":"string","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","format":"email","example":"john.doe@example.com","isRequired":true,"uniqueKey":"contacts.admin.email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15551234567","isRequired":true,"uniqueKey":"contacts.admin.phone","typeLabel":"string"},"companyName":{"oneOf":[{"description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","type":"string","example":"Example Inc.","uniqueKey":"contacts.admin.companyName.oneOf.0","typeLabel":"string"},{"description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","type":"null","example":"Example Inc.","uniqueKey":"contacts.admin.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.companyName","typeLabel":"string | null"},"address2":{"oneOf":[{"description":"The second line of the contact's address (optional).","type":"string","example":"Suite 400","uniqueKey":"contacts.admin.address2.oneOf.0","typeLabel":"string"},{"description":"The second line of the contact's address (optional).","type":"null","example":"Suite 400","uniqueKey":"contacts.admin.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.address2","typeLabel":"string | null"},"fax":{"oneOf":[{"type":"string","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15557654321","uniqueKey":"contacts.admin.fax.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15557654321","uniqueKey":"contacts.admin.fax.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.fax","typeLabel":"string | null"}},"uniqueKey":"contacts.admin","typeLabel":"object"},"billing":{"type":"object","description":"Contact contains all relevant contact data for a domain registrant. This schema is used for creating and updating contacts (POST/PUT requests) and includes all validation requirements. All fields listed in the `required` array must be provided and cannot be null or empty.","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"firstName":{"type":"string","description":"First name of the contact.","minLength":1,"example":"John","isRequired":true,"uniqueKey":"contacts.billing.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name of the contact.","minLength":1,"example":"Doe","isRequired":true,"uniqueKey":"contacts.billing.lastName","typeLabel":"string"},"address1":{"type":"string","description":"The first line of the contact's address.","minLength":1,"example":"123 Main Street","isRequired":true,"uniqueKey":"contacts.billing.address1","typeLabel":"string"},"city":{"type":"string","description":"City of the contact's address.","minLength":1,"example":"New York","isRequired":true,"uniqueKey":"contacts.billing.city","typeLabel":"string"},"state":{"type":"string","description":"State or Province of the contact's address.","minLength":1,"example":"NY","isRequired":true,"uniqueKey":"contacts.billing.state","typeLabel":"string"},"zip":{"type":"string","description":"ZIP or Postal Code of the contact's address. This field is required and must be a non-empty string.","minLength":1,"example":"10001","isRequired":true,"uniqueKey":"contacts.billing.zip","typeLabel":"string"},"country":{"type":"string","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","pattern":"^[A-Z]{2}$","example":"US","isRequired":true,"uniqueKey":"contacts.billing.country","typeLabel":"string"},"email":{"type":"string","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","format":"email","example":"john.doe@example.com","isRequired":true,"uniqueKey":"contacts.billing.email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15551234567","isRequired":true,"uniqueKey":"contacts.billing.phone","typeLabel":"string"},"companyName":{"oneOf":[{"description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","type":"string","example":"Example Inc.","uniqueKey":"contacts.billing.companyName.oneOf.0","typeLabel":"string"},{"description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","type":"null","example":"Example Inc.","uniqueKey":"contacts.billing.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.companyName","typeLabel":"string | null"},"address2":{"oneOf":[{"description":"The second line of the contact's address (optional).","type":"string","example":"Suite 400","uniqueKey":"contacts.billing.address2.oneOf.0","typeLabel":"string"},{"description":"The second line of the contact's address (optional).","type":"null","example":"Suite 400","uniqueKey":"contacts.billing.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.address2","typeLabel":"string | null"},"fax":{"oneOf":[{"type":"string","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15557654321","uniqueKey":"contacts.billing.fax.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15557654321","uniqueKey":"contacts.billing.fax.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.fax","typeLabel":"string | null"}},"uniqueKey":"contacts.billing","typeLabel":"object"},"registrant":{"type":"object","description":"Contact contains all relevant contact data for a domain registrant. This schema is used for creating and updating contacts (POST/PUT requests) and includes all validation requirements. All fields listed in the `required` array must be provided and cannot be null or empty.","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"firstName":{"type":"string","description":"First name of the contact.","minLength":1,"example":"John","isRequired":true,"uniqueKey":"contacts.registrant.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name of the contact.","minLength":1,"example":"Doe","isRequired":true,"uniqueKey":"contacts.registrant.lastName","typeLabel":"string"},"address1":{"type":"string","description":"The first line of the contact's address.","minLength":1,"example":"123 Main Street","isRequired":true,"uniqueKey":"contacts.registrant.address1","typeLabel":"string"},"city":{"type":"string","description":"City of the contact's address.","minLength":1,"example":"New York","isRequired":true,"uniqueKey":"contacts.registrant.city","typeLabel":"string"},"state":{"type":"string","description":"State or Province of the contact's address.","minLength":1,"example":"NY","isRequired":true,"uniqueKey":"contacts.registrant.state","typeLabel":"string"},"zip":{"type":"string","description":"ZIP or Postal Code of the contact's address. This field is required and must be a non-empty string.","minLength":1,"example":"10001","isRequired":true,"uniqueKey":"contacts.registrant.zip","typeLabel":"string"},"country":{"type":"string","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","pattern":"^[A-Z]{2}$","example":"US","isRequired":true,"uniqueKey":"contacts.registrant.country","typeLabel":"string"},"email":{"type":"string","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","format":"email","example":"john.doe@example.com","isRequired":true,"uniqueKey":"contacts.registrant.email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15551234567","isRequired":true,"uniqueKey":"contacts.registrant.phone","typeLabel":"string"},"companyName":{"oneOf":[{"description":"Company name of the contact. Leave blank if the contact is an individual. Please be advised that ICANN policy links the \"Company Name\" field (Organization) in your domain's contact details to its legal ownership. If this field contains information, the listed organization is considered the legal \"Registered Name Holder\" (domain owner).","type":"string","example":"Example Inc.","uniqueKey":"contacts.registrant.companyName.oneOf.0","typeLabel":"string"},{"description":"Company name of the contact. Leave blank if the contact is an individual. Please be advised that ICANN policy links the \"Company Name\" field (Organization) in your domain's contact details to its legal ownership. If this field contains information, the listed organization is considered the legal \"Registered Name Holder\" (domain owner).","type":"null","example":"Example Inc.","uniqueKey":"contacts.registrant.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.companyName","typeLabel":"string | null"},"address2":{"oneOf":[{"description":"The second line of the contact's address (optional).","type":"string","example":"Suite 400","uniqueKey":"contacts.registrant.address2.oneOf.0","typeLabel":"string"},{"description":"The second line of the contact's address (optional).","type":"null","example":"Suite 400","uniqueKey":"contacts.registrant.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.address2","typeLabel":"string | null"},"fax":{"oneOf":[{"type":"string","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15557654321","uniqueKey":"contacts.registrant.fax.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15557654321","uniqueKey":"contacts.registrant.fax.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.fax","typeLabel":"string | null"}},"uniqueKey":"contacts.registrant","typeLabel":"object"},"tech":{"type":"object","description":"Contact contains all relevant contact data for a domain registrant. This schema is used for creating and updating contacts (POST/PUT requests) and includes all validation requirements. All fields listed in the `required` array must be provided and cannot be null or empty.","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"firstName":{"type":"string","description":"First name of the contact.","minLength":1,"example":"John","isRequired":true,"uniqueKey":"contacts.tech.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name of the contact.","minLength":1,"example":"Doe","isRequired":true,"uniqueKey":"contacts.tech.lastName","typeLabel":"string"},"address1":{"type":"string","description":"The first line of the contact's address.","minLength":1,"example":"123 Main Street","isRequired":true,"uniqueKey":"contacts.tech.address1","typeLabel":"string"},"city":{"type":"string","description":"City of the contact's address.","minLength":1,"example":"New York","isRequired":true,"uniqueKey":"contacts.tech.city","typeLabel":"string"},"state":{"type":"string","description":"State or Province of the contact's address.","minLength":1,"example":"NY","isRequired":true,"uniqueKey":"contacts.tech.state","typeLabel":"string"},"zip":{"type":"string","description":"ZIP or Postal Code of the contact's address. This field is required and must be a non-empty string.","minLength":1,"example":"10001","isRequired":true,"uniqueKey":"contacts.tech.zip","typeLabel":"string"},"country":{"type":"string","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","pattern":"^[A-Z]{2}$","example":"US","isRequired":true,"uniqueKey":"contacts.tech.country","typeLabel":"string"},"email":{"type":"string","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","format":"email","example":"john.doe@example.com","isRequired":true,"uniqueKey":"contacts.tech.email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15551234567","isRequired":true,"uniqueKey":"contacts.tech.phone","typeLabel":"string"},"companyName":{"oneOf":[{"description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","type":"string","example":"Example Inc.","uniqueKey":"contacts.tech.companyName.oneOf.0","typeLabel":"string"},{"description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","type":"null","example":"Example Inc.","uniqueKey":"contacts.tech.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.companyName","typeLabel":"string | null"},"address2":{"oneOf":[{"description":"The second line of the contact's address (optional).","type":"string","example":"Suite 400","uniqueKey":"contacts.tech.address2.oneOf.0","typeLabel":"string"},{"description":"The second line of the contact's address (optional).","type":"null","example":"Suite 400","uniqueKey":"contacts.tech.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.address2","typeLabel":"string | null"},"fax":{"oneOf":[{"type":"string","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15557654321","uniqueKey":"contacts.tech.fax.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","pattern":"^\\+[1-9]\\d{7,14}$","example":"+15557654321","uniqueKey":"contacts.tech.fax.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.fax","typeLabel":"string | null"}},"uniqueKey":"contacts.tech","typeLabel":"object"}},"uniqueKey":"contacts","typeLabel":"object"}},"required":["domainName","authCode"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"domainName":"example.com","authCode":"ABC123","contacts":{}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"93ba034d-5ff7-4b6f-b7b4-d52adfa379b0":{"description":"The domain was accepted into the gaining account. The response body matches the domain resource representation used elsewhere in the API (same shape as Get Domain / Set Contacts).","content":{"application/json":{"schema":{"type":"object","description":"The response format for a domain.","required":["domainName","createDate","expireDate","autorenewEnabled","locked","privacyEnabled","contacts","nameservers"],"properties":{"domainName":{"type":"string","description":"The punycode-encoded value of the domain name.","example":"example.com","isRequired":true,"uniqueKey":"domainName","typeLabel":"string"},"createDate":{"type":"string","description":"The date and time when the domain was created at the registry.","format":"date-time","readOnly":true,"example":"2023-01-15T14:30:00Z","isRequired":true,"uniqueKey":"createDate","typeLabel":"string\u003cdate-time>"},"expireDate":{"type":"string","description":"The date and time when the domain will expire.","format":"date-time","readOnly":true,"example":"2025-01-15T14:30:00Z","isRequired":true,"uniqueKey":"expireDate","typeLabel":"string\u003cdate-time>"},"autorenewEnabled":{"type":"boolean","description":"Indicates whether the domain is set to renew automatically before expiration.","example":true,"isRequired":true,"uniqueKey":"autorenewEnabled","typeLabel":"boolean"},"locked":{"type":"boolean","description":"Indicates if the domain is **transfer locked**, preventing transfers to another registrar.","example":true,"isRequired":true,"uniqueKey":"locked","typeLabel":"boolean"},"privacyEnabled":{"type":"boolean","description":"Indicates if Whois Privacy is enabled for this domain.","example":true,"isRequired":true,"uniqueKey":"privacyEnabled","typeLabel":"boolean"},"contacts":{"type":"object","description":"Contacts stores the contact information for the roles related to domains.","properties":{"admin":{"type":"object","description":"Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements.","properties":{"firstName":{"oneOf":[{"type":"string","description":"First name of the contact.","example":"John","uniqueKey":"contacts.admin.firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"First name of the contact.","example":"John","uniqueKey":"contacts.admin.firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"Last name of the contact.","example":"Doe","uniqueKey":"contacts.admin.lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last name of the contact.","example":"Doe","uniqueKey":"contacts.admin.lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.lastName","typeLabel":"string | null"},"companyName":{"oneOf":[{"type":"string","description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","example":"Example Inc.","uniqueKey":"contacts.admin.companyName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","example":"Example Inc.","uniqueKey":"contacts.admin.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.companyName","typeLabel":"string | null"},"address1":{"oneOf":[{"type":"string","description":"The first line of the contact's address.","example":"123 Main Street","uniqueKey":"contacts.admin.address1.oneOf.0","typeLabel":"string"},{"type":"null","description":"The first line of the contact's address.","example":"123 Main Street","uniqueKey":"contacts.admin.address1.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.address1","typeLabel":"string | null"},"address2":{"oneOf":[{"type":"string","description":"The second line of the contact's address (optional).","example":"Suite 400","uniqueKey":"contacts.admin.address2.oneOf.0","typeLabel":"string"},{"type":"null","description":"The second line of the contact's address (optional).","example":"Suite 400","uniqueKey":"contacts.admin.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.address2","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","description":"City of the contact's address.","example":"New York","uniqueKey":"contacts.admin.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City of the contact's address.","example":"New York","uniqueKey":"contacts.admin.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","description":"State or Province of the contact's address.","example":"NY","uniqueKey":"contacts.admin.state.oneOf.0","typeLabel":"string"},{"type":"null","description":"State or Province of the contact's address.","example":"NY","uniqueKey":"contacts.admin.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.state","typeLabel":"string | null"},"zip":{"oneOf":[{"type":"string","description":"ZIP or Postal Code of the contact's address.","example":"10001","uniqueKey":"contacts.admin.zip.oneOf.0","typeLabel":"string"},{"type":"null","description":"ZIP or Postal Code of the contact's address.","example":"10001","uniqueKey":"contacts.admin.zip.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.zip","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","example":"US","uniqueKey":"contacts.admin.country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","example":"US","uniqueKey":"contacts.admin.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.country","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","example":"john.doe@example.com","uniqueKey":"contacts.admin.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","example":"john.doe@example.com","uniqueKey":"contacts.admin.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15551234567","uniqueKey":"contacts.admin.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15551234567","uniqueKey":"contacts.admin.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.phone","typeLabel":"string | null"},"fax":{"oneOf":[{"type":"string","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15557654321","uniqueKey":"contacts.admin.fax.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15557654321","uniqueKey":"contacts.admin.fax.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.fax","typeLabel":"string | null"},"isVerified":{"type":"boolean","description":"Indicates if the contact has been verified as per ICANN requirements. If the value is `false` it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.","readOnly":true,"example":true,"uniqueKey":"contacts.admin.isVerified","typeLabel":"boolean"},"verificationId":{"oneOf":[{"type":"integer","description":"When the contact is unverified, this is the ID of the pending verification record. Use this ID with the resend verification email and verify contact endpoints. Omitted or null when the contact is verified.","format":"int64","readOnly":true,"example":12345,"uniqueKey":"contacts.admin.verificationId.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","description":"When the contact is unverified, this is the ID of the pending verification record. Use this ID with the resend verification email and verify contact endpoints. Omitted or null when the contact is verified.","format":"int64","readOnly":true,"example":12345,"uniqueKey":"contacts.admin.verificationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.admin.verificationId","typeLabel":"integer\u003cint64> | null"}},"uniqueKey":"contacts.admin","typeLabel":"object"},"billing":{"type":"object","description":"Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements.","properties":{"firstName":{"oneOf":[{"type":"string","description":"First name of the contact.","example":"John","uniqueKey":"contacts.billing.firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"First name of the contact.","example":"John","uniqueKey":"contacts.billing.firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"Last name of the contact.","example":"Doe","uniqueKey":"contacts.billing.lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last name of the contact.","example":"Doe","uniqueKey":"contacts.billing.lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.lastName","typeLabel":"string | null"},"companyName":{"oneOf":[{"type":"string","description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","example":"Example Inc.","uniqueKey":"contacts.billing.companyName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","example":"Example Inc.","uniqueKey":"contacts.billing.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.companyName","typeLabel":"string | null"},"address1":{"oneOf":[{"type":"string","description":"The first line of the contact's address.","example":"123 Main Street","uniqueKey":"contacts.billing.address1.oneOf.0","typeLabel":"string"},{"type":"null","description":"The first line of the contact's address.","example":"123 Main Street","uniqueKey":"contacts.billing.address1.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.address1","typeLabel":"string | null"},"address2":{"oneOf":[{"type":"string","description":"The second line of the contact's address (optional).","example":"Suite 400","uniqueKey":"contacts.billing.address2.oneOf.0","typeLabel":"string"},{"type":"null","description":"The second line of the contact's address (optional).","example":"Suite 400","uniqueKey":"contacts.billing.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.address2","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","description":"City of the contact's address.","example":"New York","uniqueKey":"contacts.billing.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City of the contact's address.","example":"New York","uniqueKey":"contacts.billing.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","description":"State or Province of the contact's address.","example":"NY","uniqueKey":"contacts.billing.state.oneOf.0","typeLabel":"string"},{"type":"null","description":"State or Province of the contact's address.","example":"NY","uniqueKey":"contacts.billing.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.state","typeLabel":"string | null"},"zip":{"oneOf":[{"type":"string","description":"ZIP or Postal Code of the contact's address.","example":"10001","uniqueKey":"contacts.billing.zip.oneOf.0","typeLabel":"string"},{"type":"null","description":"ZIP or Postal Code of the contact's address.","example":"10001","uniqueKey":"contacts.billing.zip.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.zip","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","example":"US","uniqueKey":"contacts.billing.country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","example":"US","uniqueKey":"contacts.billing.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.country","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","example":"john.doe@example.com","uniqueKey":"contacts.billing.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","example":"john.doe@example.com","uniqueKey":"contacts.billing.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15551234567","uniqueKey":"contacts.billing.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15551234567","uniqueKey":"contacts.billing.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.phone","typeLabel":"string | null"},"fax":{"oneOf":[{"type":"string","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15557654321","uniqueKey":"contacts.billing.fax.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15557654321","uniqueKey":"contacts.billing.fax.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.fax","typeLabel":"string | null"},"isVerified":{"type":"boolean","description":"Indicates if the contact has been verified as per ICANN requirements. If the value is `false` it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.","readOnly":true,"example":true,"uniqueKey":"contacts.billing.isVerified","typeLabel":"boolean"},"verificationId":{"oneOf":[{"type":"integer","description":"When the contact is unverified, this is the ID of the pending verification record. Use this ID with the resend verification email and verify contact endpoints. Omitted or null when the contact is verified.","format":"int64","readOnly":true,"example":12345,"uniqueKey":"contacts.billing.verificationId.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","description":"When the contact is unverified, this is the ID of the pending verification record. Use this ID with the resend verification email and verify contact endpoints. Omitted or null when the contact is verified.","format":"int64","readOnly":true,"example":12345,"uniqueKey":"contacts.billing.verificationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.billing.verificationId","typeLabel":"integer\u003cint64> | null"}},"uniqueKey":"contacts.billing","typeLabel":"object"},"registrant":{"type":"object","description":"Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use RegistrantContactRequest which enforces all validation requirements.","properties":{"firstName":{"oneOf":[{"type":"string","description":"First name of the contact.","example":"John","uniqueKey":"contacts.registrant.firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"First name of the contact.","example":"John","uniqueKey":"contacts.registrant.firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"Last name of the contact.","example":"Doe","uniqueKey":"contacts.registrant.lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last name of the contact.","example":"Doe","uniqueKey":"contacts.registrant.lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.lastName","typeLabel":"string | null"},"companyName":{"oneOf":[{"type":"string","description":"Company name of the contact. Leave blank if the contact is an individual. Please be advised that ICANN policy links the \"Company Name\" field (Organization) in your domain's contact details to its legal ownership. If this field contains information, the listed organization is considered the legal \"Registered Name Holder\" (domain owner).","example":"Example Inc.","uniqueKey":"contacts.registrant.companyName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Company name of the contact. Leave blank if the contact is an individual. Please be advised that ICANN policy links the \"Company Name\" field (Organization) in your domain's contact details to its legal ownership. If this field contains information, the listed organization is considered the legal \"Registered Name Holder\" (domain owner).","example":"Example Inc.","uniqueKey":"contacts.registrant.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.companyName","typeLabel":"string | null"},"address1":{"oneOf":[{"type":"string","description":"The first line of the contact's address.","example":"123 Main Street","uniqueKey":"contacts.registrant.address1.oneOf.0","typeLabel":"string"},{"type":"null","description":"The first line of the contact's address.","example":"123 Main Street","uniqueKey":"contacts.registrant.address1.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.address1","typeLabel":"string | null"},"address2":{"oneOf":[{"type":"string","description":"The second line of the contact's address (optional).","example":"Suite 400","uniqueKey":"contacts.registrant.address2.oneOf.0","typeLabel":"string"},{"type":"null","description":"The second line of the contact's address (optional).","example":"Suite 400","uniqueKey":"contacts.registrant.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.address2","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","description":"City of the contact's address.","example":"New York","uniqueKey":"contacts.registrant.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City of the contact's address.","example":"New York","uniqueKey":"contacts.registrant.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","description":"State or Province of the contact's address.","example":"NY","uniqueKey":"contacts.registrant.state.oneOf.0","typeLabel":"string"},{"type":"null","description":"State or Province of the contact's address.","example":"NY","uniqueKey":"contacts.registrant.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.state","typeLabel":"string | null"},"zip":{"oneOf":[{"type":"string","description":"ZIP or Postal Code of the contact's address.","example":"10001","uniqueKey":"contacts.registrant.zip.oneOf.0","typeLabel":"string"},{"type":"null","description":"ZIP or Postal Code of the contact's address.","example":"10001","uniqueKey":"contacts.registrant.zip.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.zip","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","example":"US","uniqueKey":"contacts.registrant.country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","example":"US","uniqueKey":"contacts.registrant.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.country","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","example":"john.doe@example.com","uniqueKey":"contacts.registrant.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","example":"john.doe@example.com","uniqueKey":"contacts.registrant.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15551234567","uniqueKey":"contacts.registrant.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15551234567","uniqueKey":"contacts.registrant.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.phone","typeLabel":"string | null"},"fax":{"oneOf":[{"type":"string","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15557654321","uniqueKey":"contacts.registrant.fax.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15557654321","uniqueKey":"contacts.registrant.fax.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.fax","typeLabel":"string | null"},"isVerified":{"type":"boolean","description":"Indicates if the contact has been verified as per ICANN requirements. If the value is `false` it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.","readOnly":true,"example":true,"uniqueKey":"contacts.registrant.isVerified","typeLabel":"boolean"},"verificationId":{"oneOf":[{"type":"integer","description":"When the contact is unverified, this is the ID of the pending verification record. Use this ID with the resend verification email and verify contact endpoints. Omitted or null when the contact is verified.","format":"int64","readOnly":true,"example":12345,"uniqueKey":"contacts.registrant.verificationId.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","description":"When the contact is unverified, this is the ID of the pending verification record. Use this ID with the resend verification email and verify contact endpoints. Omitted or null when the contact is verified.","format":"int64","readOnly":true,"example":12345,"uniqueKey":"contacts.registrant.verificationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.registrant.verificationId","typeLabel":"integer\u003cint64> | null"}},"uniqueKey":"contacts.registrant","typeLabel":"object"},"tech":{"type":"object","description":"Contact contains all relevant contact data for a domain registrant. This schema is used for API responses and may contain null values for legacy data. For creating or updating contacts, use ContactRequest which enforces all validation requirements.","properties":{"firstName":{"oneOf":[{"type":"string","description":"First name of the contact.","example":"John","uniqueKey":"contacts.tech.firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"First name of the contact.","example":"John","uniqueKey":"contacts.tech.firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"Last name of the contact.","example":"Doe","uniqueKey":"contacts.tech.lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last name of the contact.","example":"Doe","uniqueKey":"contacts.tech.lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.lastName","typeLabel":"string | null"},"companyName":{"oneOf":[{"type":"string","description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","example":"Example Inc.","uniqueKey":"contacts.tech.companyName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Company name of the contact. Leave blank if the contact is an individual, as some registries may assume it is a corporate entity otherwise.","example":"Example Inc.","uniqueKey":"contacts.tech.companyName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.companyName","typeLabel":"string | null"},"address1":{"oneOf":[{"type":"string","description":"The first line of the contact's address.","example":"123 Main Street","uniqueKey":"contacts.tech.address1.oneOf.0","typeLabel":"string"},{"type":"null","description":"The first line of the contact's address.","example":"123 Main Street","uniqueKey":"contacts.tech.address1.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.address1","typeLabel":"string | null"},"address2":{"oneOf":[{"type":"string","description":"The second line of the contact's address (optional).","example":"Suite 400","uniqueKey":"contacts.tech.address2.oneOf.0","typeLabel":"string"},{"type":"null","description":"The second line of the contact's address (optional).","example":"Suite 400","uniqueKey":"contacts.tech.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.address2","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","description":"City of the contact's address.","example":"New York","uniqueKey":"contacts.tech.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City of the contact's address.","example":"New York","uniqueKey":"contacts.tech.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","description":"State or Province of the contact's address.","example":"NY","uniqueKey":"contacts.tech.state.oneOf.0","typeLabel":"string"},{"type":"null","description":"State or Province of the contact's address.","example":"NY","uniqueKey":"contacts.tech.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.state","typeLabel":"string | null"},"zip":{"oneOf":[{"type":"string","description":"ZIP or Postal Code of the contact's address.","example":"10001","uniqueKey":"contacts.tech.zip.oneOf.0","typeLabel":"string"},{"type":"null","description":"ZIP or Postal Code of the contact's address.","example":"10001","uniqueKey":"contacts.tech.zip.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.zip","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","example":"US","uniqueKey":"contacts.tech.country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Country code for the contact's address. Must be an ISO 3166-1 alpha-2 country code.","example":"US","uniqueKey":"contacts.tech.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.country","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","example":"john.doe@example.com","uniqueKey":"contacts.tech.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"Email address of the contact. Must be a valid email format. The validation is performed against the `addr-spec` syntax in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822)","example":"john.doe@example.com","uniqueKey":"contacts.tech.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15551234567","uniqueKey":"contacts.tech.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phone number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15551234567","uniqueKey":"contacts.tech.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.phone","typeLabel":"string | null"},"fax":{"oneOf":[{"type":"string","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15557654321","uniqueKey":"contacts.tech.fax.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fax number of the contact. Should follow the E.164 international format: \"+[country code][number]\".","example":"+15557654321","uniqueKey":"contacts.tech.fax.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.fax","typeLabel":"string | null"},"isVerified":{"type":"boolean","description":"Indicates if the contact has been verified as per ICANN requirements. If the value is `false` it indicates that the contact has not completed the required verification process. This property is read-only and will be included in responses but should not be included in requests.","readOnly":true,"example":true,"uniqueKey":"contacts.tech.isVerified","typeLabel":"boolean"},"verificationId":{"oneOf":[{"type":"integer","description":"When the contact is unverified, this is the ID of the pending verification record. Use this ID with the resend verification email and verify contact endpoints. Omitted or null when the contact is verified.","format":"int64","readOnly":true,"example":12345,"uniqueKey":"contacts.tech.verificationId.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","description":"When the contact is unverified, this is the ID of the pending verification record. Use this ID with the resend verification email and verify contact endpoints. Omitted or null when the contact is verified.","format":"int64","readOnly":true,"example":12345,"uniqueKey":"contacts.tech.verificationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"contacts.tech.verificationId","typeLabel":"integer\u003cint64> | null"}},"uniqueKey":"contacts.tech","typeLabel":"object"}},"isRequired":true,"uniqueKey":"contacts","typeLabel":"object"},"nameservers":{"type":"array","items":{"type":"string","uniqueKey":"nameservers.items.[INDEX]","typeLabel":"string"},"description":"The list of nameservers assigned to this domain. If unspecified, it defaults to the account's default nameservers.","example":["ns1.example.com","ns2.example.com"],"isRequired":true,"uniqueKey":"nameservers","typeLabel":"string[]"},"locks":{"description":"List of all registry locking statuses currently applied to the domain. Use this to see which locks are active (e.g. clientTransferProhibited, clientHold). Empty when the domain has no locks applied.","type":"array","items":{"type":"string","uniqueKey":"locks.items.[INDEX]","typeLabel":"string"},"readOnly":true,"example":["clientTransferProhibited","clientHold"],"uniqueKey":"locks","typeLabel":"string[]"},"transferLockExpiresAt":{"type":"string","description":"When present, the domain has an active ICANN-mandated transfer lock (new registration, transfer-in, or material registrant contact change) that blocks client unlock via the API until this time. When omitted, there is no active policy transfer lock with a known expiry — the domain may still be locked (`locked: true`) due to a voluntary user lock. Does not represent RegistrarLock, AccountLock, verification holds, trademark-claim locks, or admin TransferLock with no expiry date.","format":"date-time","readOnly":true,"example":"2023-03-16T14:30:00Z","uniqueKey":"transferLockExpiresAt","typeLabel":"string\u003cdate-time>"},"renewalPrice":{"type":"number","description":"The cost to renew the domain. This may be required for the RenewDomain operation.","format":"double","readOnly":true,"example":12.99,"uniqueKey":"renewalPrice","typeLabel":"number\u003cdouble>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"domainName":"example.com","createDate":"2023-01-15T14:30:00Z","expireDate":"2025-01-15T14:30:00Z","autorenewEnabled":true,"locked":true,"privacyEnabled":true,"contacts":{"admin":{"firstName":"John","lastName":"Doe","companyName":"Example Inc.","address1":"123 Main Street","address2":"Suite 400","city":"New York","state":"NY","zip":"10001","country":"US","email":"john.doe@example.com","phone":"+15551234567","fax":"+15557654321","isVerified":true,"verificationId":12345},"billing":{"firstName":"John","lastName":"Doe","companyName":"Example Inc.","address1":"123 Main Street","address2":"Suite 400","city":"New York","state":"NY","zip":"10001","country":"US","email":"john.doe@example.com","phone":"+15551234567","fax":"+15557654321","isVerified":true,"verificationId":12345},"registrant":{"firstName":"John","lastName":"Doe","companyName":"Example Inc.","address1":"123 Main Street","address2":"Suite 400","city":"New York","state":"NY","zip":"10001","country":"US","email":"john.doe@example.com","phone":"+15551234567","fax":"+15557654321","isVerified":true,"verificationId":12345},"tech":{"firstName":"John","lastName":"Doe","companyName":"Example Inc.","address1":"123 Main Street","address2":"Suite 400","city":"New York","state":"NY","zip":"10001","country":"US","email":"john.doe@example.com","phone":"+15551234567","fax":"+15557654321","isVerified":true,"verificationId":12345}},"nameservers":["ns1.example.com","ns2.example.com"],"locks":["clientTransferProhibited","clientHold"],"transferLockExpiresAt":"2023-03-16T14:30:00Z","renewalPrice":12.99}}},"exampleType":"generated"}},"exampleType":"generated"},"59725600-d601-41c3-8b2f-8c7cc4cc5027":{"description":"Validation failed (missing or invalid fields, invalid authorization code, or other bad input). The `message` and `details` fields describe what to correct.","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":{"missingAuthCode":{"title":"missingAuthCode","value":{"message":"Bad Request","details":"'authCode' is required"}},"invalidAuthCode":{"title":"invalidAuthCode","value":{"message":"Bad Request","details":"The authorization code is invalid or has expired."}}},"exampleType":"examples"}},"exampleType":"examples"},"7fbf9c67-d853-4c99-89de-550d13b02f44":{"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"},"de8fd99c-eddb-44f9-ba73-3d52aaff5cb9":{"description":"Forbidden — for example, when the authenticated account is not allowlisted for internal transfers (enterprise-only; initial rollout is limited to designated partners), or when the caller otherwise lacks permission to use this operation.","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"},"67387879-1cd2-411f-afe9-cc40535d336f":{"description":"The domain could not be found for an internal transfer from another name.com account, or it is not eligible to be pulled into the gaining account.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error","example":"Not Found","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error","example":"The requested domain does not exist.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error","example":"The requested domain does not exist.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"domainNotFound":{"title":"domainNotFound","value":{"message":"Not Found","details":"No eligible domain was found in another name.com account for this request."}}},"exampleType":"examples"}},"exampleType":"examples"},"cd14762d-586d-4c9a-b1ac-7658311a7039":{"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"},"0abb582f-706a-4af5-a7ac-afcb23243ba9":{"description":"The domain is in a state that blocks the operation — for example, **registrar transfer lock** is still active (`clientTransferProhibited` or equivalent). The losing account must remove transfer lock in the name.com dashboard before retrying.","content":{"application/json":{"schema":{"type":"object","description":"A conflict error response.","required":["message"],"properties":{"message":{"type":"string","description":"A human-readable error message describing the conflict","example":"Object already exists.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional context or information about the error","example":"Cannot create multiple objects under same key.","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context or information about the error","example":"Cannot create multiple objects under same key.","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"transferLockActive":{"title":"transferLockActive","value":{"message":"Conflict","details":"The domain is locked for transfer at the registrar. Unlock the domain in the losing account's name.com dashboard, then retry."}}},"exampleType":"examples"}},"exampleType":"examples"},"49e09111-ad2a-4b83-b78a-b8769d8d9e72":{"description":"POST requests must include `Content-Type: application/json`.","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"},"bc7c6fe0-2fb8-4180-903d-7861d4b3220b":{"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"},"a1d438f8-25d8-439f-bea0-1a782bf39c73":{"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"},"e70d3be4-c471-444d-a592-2e6f097e7d95":{"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"},"1ae5a791-f229-4ab3-820a-0f75131f47f5":{"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"},"17cef1fc-81ea-4bcc-bd85-3e3ec63ceced":{"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":"Create Internal Transfer In - name.com Core API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-04T19:55:58.476Z","originalFileLocation":"api/v1/reference/transfers/create-internal-transfer-in.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=\"Pulls a domain from another name.com account into your reseller (gaining) account using a valid authorization code. This is an internal name.com-to-name.com move; it is separate from Create Transfer, which brings domains in from external registrars. Check if a TLD is eligible for internal transfer in by calling Tld Requirements for the TLD and checking property supportsInternalTransfer. This API is only available to approved reseller accounts. Contact name.com support to request access. #### Losing account (dashboard only) The party that holds the domain today must use the name.com dashboard on the losing account to unlock the domain (remove registrar transfer lock) and to copy the authorization code to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account. #### Gaining account (this API) Call this endpoint with domainName, authCode, and optional contacts using the gaining reseller\u0026#x27;s API credentials. #### Contacts and post-transfer lock If contacts is omitted, the gaining account\u0026#x27;s default contacts are applied. If contacts is provided, any roles included in the request are applied and omitted roles use the gaining account\u0026#x27;s default contacts (same pattern as Create Domain and Set Contacts). The 60-day contact-change transfer lock is enforced based on the gaining account\u0026#x27;s settings, consistent with Set Contacts. #### Access Restricted to approved enterprise resellers; other callers receive 403 Forbidden.\">\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=\"Create Internal Transfer In - name.com Core API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Pulls a domain from another name.com account into your reseller (gaining) account using a valid authorization code. This is an internal name.com-to-name.com move; it is separate from Create Transfer, which brings domains in from external registrars. Check if a TLD is eligible for internal transfer in by calling Tld Requirements for the TLD and checking property supportsInternalTransfer. This API is only available to approved reseller accounts. Contact name.com support to request access. #### Losing account (dashboard only) The party that holds the domain today must use the name.com dashboard on the losing account to unlock the domain (remove registrar transfer lock) and to copy the authorization code to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account. #### Gaining account (this API) Call this endpoint with domainName, authCode, and optional contacts using the gaining reseller\u0026#x27;s API credentials. #### Contacts and post-transfer lock If contacts is omitted, the gaining account\u0026#x27;s default contacts are applied. If contacts is provided, any roles included in the request are applied and omitted roles use the gaining account\u0026#x27;s default contacts (same pattern as Create Domain and Set Contacts). The 60-day contact-change transfer lock is enforced based on the gaining account\u0026#x27;s settings, consistent with Set Contacts. #### Access Restricted to approved enterprise resellers; other callers receive 403 Forbidden.\">\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/transfers/create-internal-transfer-in\">\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=Internal\u0026amp;title=Create+Internal+Transfer+In\u0026amp;description=Pulls+a+domain+from+another+%5Bname.com%5D%28https%3A%2F%2Fwww.name.com%29+account+into+your+reseller+%28gaining%29+account+using+a+valid+authorization+code.+This+is+an+**interna\u0026amp;theme=a954cb13cd71ba157cb20fc0\u0026amp;signature=bbcd0cb04a7b94616b6a8dca70d0eba71d06e4b55be0619ad607ab73e3f1233a\">\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=\"Create Internal Transfer In - name.com Core API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Pulls a domain from another name.com account into your reseller (gaining) account using a valid authorization code. This is an internal name.com-to-name.com move; it is separate from Create Transfer, which brings domains in from external registrars. Check if a TLD is eligible for internal transfer in by calling Tld Requirements for the TLD and checking property supportsInternalTransfer. This API is only available to approved reseller accounts. Contact name.com support to request access. #### Losing account (dashboard only) The party that holds the domain today must use the name.com dashboard on the losing account to unlock the domain (remove registrar transfer lock) and to copy the authorization code to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account. #### Gaining account (this API) Call this endpoint with domainName, authCode, and optional contacts using the gaining reseller\u0026#x27;s API credentials. #### Contacts and post-transfer lock If contacts is omitted, the gaining account\u0026#x27;s default contacts are applied. If contacts is provided, any roles included in the request are applied and omitted roles use the gaining account\u0026#x27;s default contacts (same pattern as Create Domain and Set Contacts). The 60-day contact-change transfer lock is enforced based on the gaining account\u0026#x27;s settings, consistent with Set Contacts. #### Access Restricted to approved enterprise resellers; other callers receive 403 Forbidden.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://namecom.mintlify.app/_mintlify/api/og/v2?division=Internal\u0026amp;title=Create+Internal+Transfer+In\u0026amp;description=Pulls+a+domain+from+another+%5Bname.com%5D%28https%3A%2F%2Fwww.name.com%29+account+into+your+reseller+%28gaining%29+account+using+a+valid+authorization+code.+This+is+an+**interna\u0026amp;theme=a954cb13cd71ba157cb20fc0\u0026amp;signature=bbcd0cb04a7b94616b6a8dca70d0eba71d06e4b55be0619ad607ab73e3f1233a\">\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/transfers/create-internal-transfer-in\">\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/transfers/create-internal-transfer-in.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/transfers/create-internal-transfer-in#webpage\",\"url\":\"https://docs.name.com/api/v1/reference/transfers/create-internal-transfer-in\",\"name\":\"Create Internal Transfer In\",\"description\":\"Pulls a domain from another name.com account into your reseller (gaining) account using a valid authorization code. This is an internal name.com-to-name.com move; it is separate from Create Transfer, which brings domains in from external registrars. Check if a TLD is eligible for internal transfer in by calling Tld Requirements for the TLD and checking property supportsInternalTransfer. This API is only available to approved reseller accounts. Contact name.com support to request access. #### Losing account (dashboard only) The party that holds the domain today must use the name.com dashboard on the losing account to unlock the domain (remove registrar transfer lock) and to copy the authorization code to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account. #### Gaining account (this API) Call this endpoint with domainName, authCode, and optional contacts using the gaining reseller's API credentials. #### Contacts and post-transfer lock If contacts is omitted, the gaining account's default contacts are applied. If contacts is provided, any roles included in the request are applied and omitted roles use the gaining account's default contacts (same pattern as Create Domain and Set Contacts). The 60-day contact-change transfer lock is enforced based on the gaining account's settings, consistent with Set Contacts. #### Access Restricted to approved enterprise resellers; other callers receive 403 Forbidden.\",\"dateModified\":\"2026-06-04T19:55:58.476Z\",\"isPartOf\":{\"@id\":\"https://docs.name.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.name.com/api/v1/reference/transfers/create-internal-transfer-in#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.name.com/api/v1/reference/transfers/create-internal-transfer-in#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core API Reference\",\"item\":\"https://docs.name.com/api/v1/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transfers\",\"item\":\"https://docs.name.com/api/v1/reference/transfers/get-transfer-eligibility\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Internal Transfer In\",\"item\":\"https://docs.name.com/api/v1/reference/transfers/create-internal-transfer-in\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.name.com/api/v1/reference/transfers/create-internal-transfer-in#apireference\",\"headline\":\"Create Internal Transfer In\",\"name\":\"Create Internal Transfer In\",\"description\":\"Pulls a domain from another name.com account into your reseller (gaining) account using a valid authorization code. This is an internal name.com-to-name.com move; it is separate from Create Transfer, which brings domains in from external registrars. Check if a TLD is eligible for internal transfer in by calling Tld Requirements for the TLD and checking property supportsInternalTransfer. This API is only available to approved reseller accounts. Contact name.com support to request access. #### Losing account (dashboard only) The party that holds the domain today must use the name.com dashboard on the losing account to unlock the domain (remove registrar transfer lock) and to copy the authorization code to provide to your integration. This endpoint does not unlock the domain or retrieve the auth code for the losing account. #### Gaining account (this API) Call this endpoint with domainName, authCode, and optional contacts using the gaining reseller's API credentials. #### Contacts and post-transfer lock If contacts is omitted, the gaining account's default contacts are applied. If contacts is provided, any roles included in the request are applied and omitted roles use the gaining account's default contacts (same pattern as Create Domain and Set Contacts). The 60-day contact-change transfer lock is enforced based on the gaining account's settings, consistent with Set Contacts. #### Access Restricted to approved enterprise resellers; other callers receive 403 Forbidden.\",\"url\":\"https://docs.name.com/api/v1/reference/transfers/create-internal-transfer-in\",\"mainEntityOfPage\":{\"@id\":\"https://docs.name.com/api/v1/reference/transfers/create-internal-transfer-in#webpage\"},\"dateModified\":\"2026-06-04T19:55:58.476Z\",\"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","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","description":"Cancels an outbound transfer for the given domain. Use this when the domain is being transferred out of name.com (losing registrar) to another (gaining) registrar and the registrant or reseller wants to cancel that transfer.\nOn success, subscribers receive `domain.transfer_out.status_change` with status `canceled`.\nThe endpoint validates that the domain exists and belongs to the authenticated account. Only domains in a pending transfer (out) state can be canceled.","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","description":"Sets up a new URL forwarding (redirect) for a domain or subdomain. If this is the first URL forwarding entry, it may modify the A records for the domain accordingly. Note that changes may take up to 24 hours to fully propagate.","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"}]}]},"title":"Create Internal Transfer In - name.com Core API","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}