Skip to main content

domains

Overview

Namedomains
TypeResource
Idvercel.domains.domains

Fields

NameDatatypeDescription
idstringThe unique identifier of the domain.
namestringThe domain name.
boughtAtnumberIf it was purchased through Vercel, the timestamp in milliseconds when it was purchased.
createdAtnumberTimestamp in milliseconds when the domain was created in the registry.
creatorobjectAn object containing information of the domain creator, including the user's id, username, and email.
customNameserversarrayA list of custom nameservers for the domain to point to. Only applies to domains purchased with Vercel.
expiresAtnumberTimestamp in milliseconds at which the domain is set to expire. null if not bought with Vercel.
intendedNameserversarrayA list of the intended nameservers for the domain to point to Vercel DNS.
nameserversarrayA list of the current nameservers of the domain.
orderedAtnumberTimestamp in milliseconds at which the domain was ordered.
renewbooleanIndicates whether the domain is set to automatically renew.
serviceTypestringThe type of service the domain is handled by. external if the DNS is externally handled, zeit.world if handled with Vercel, or na if the service is not available.
suffixboolean
transferStartedAtnumberIf transferred into Vercel, timestamp in milliseconds when the domain transfer was initiated.
transferredAtnumberTimestamp in milliseconds at which the domain was successfully transferred into Vercel. null if the transfer is still processing or was never transferred in.
verifiedbooleanIf the domain has the ownership verified.

Methods

NameAccessible byRequired ParamsDescription
get_domainSELECTdomain, teamIdGet information for a single domain in an account or team.
get_domainsSELECTteamIdRetrieves a list of domains registered for the authenticated user or team. By default it returns the last 20 domains if no limit is provided.
create_or_transfer_domainINSERTteamIdThis endpoint is used for adding a new apex domain name with Vercel for the authenticating user. Can also be used for initiating a domain transfer request from an external Registrar to Vercel.
delete_domainDELETEdomain, teamIdDelete a previously registered domain name from Vercel. Deleting a domain will automatically remove any associated aliases.
_get_domainEXECdomain, teamIdGet information for a single domain in an account or team.
_get_domainsEXECteamIdRetrieves a list of domains registered for the authenticated user or team. By default it returns the last 20 domains if no limit is provided.
buy_domainEXECteamId, data__nameAllows to purchase the specified domain.
patch_domainEXECdomain, teamIdUpdate or move apex domain.