Skip to main content

domain_registry

Creates, updates, deletes, gets or lists a domain_registry resource.

Overview

Namedomain_registry
TypeResource
Idvercel.domains.domain_registry

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
reasonstringDescription associated with transferable state.
statusstringThe current state of an ongoing transfer. pending_owner: Awaiting approval by domain's admin contact (every transfer begins with this status). If approval is not given within five days, the transfer is cancelled. pending_admin: Waiting for approval by Vercel Registrar admin. pending_registry: Awaiting registry approval (the transfer completes after 7 days unless it is declined by the current registrar). completed: The transfer completed successfully. cancelled: The transfer was cancelled. undef: No transfer exists for this domain. unknown: This TLD is not supported by Vercel's Registrar.
transferPolicystringThe domain's transfer policy (depends on TLD requirements). charge-and-renew: transfer will charge for renewal and will renew the existing domain's registration. no-charge-no-change: transfer will have no change to registration period and does not require charge. no-change: transfer charge is required, but no change in registration period. new-term: transfer charge is required and a new registry term is set based on the transfer date. not-supported: transfers are not supported for this domain or TLD. null: This TLD is not supported by Vercel's Registrar.
transferablebooleanWhether or not the domain is transferable

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_domain_transferselectdomain, teamIdFetch domain transfer availability or transfer status if a transfer is in progress.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
domainstringThe name of the domain.
teamIdstringThe Team identifier or slug to perform the request on behalf of.

SELECT examples

Fetch domain transfer availability or transfer status if a transfer is in progress.

SELECT
reason,
status,
transferPolicy,
transferable
FROM vercel.domains.domain_registry
WHERE domain = '{{ domain }}' -- required
AND teamId = '{{ teamId }}' -- required
;