Scaleway logo
Domain names - Registrar API

List domains

GET
https://api.scaleway.com
/domain/v2beta1/domains

Retrieve the list of domains you own.

List domains › query Parameters

page
​google.protobuf.Int32Value · int32
page_size
​integer · uint32
Enum values:
domain_asc
domain_desc
Default: domain_asc
status
​scaleway.domain.v2beta1.Domain.Status · enum
Enum values:
status_unknown
active
creating
create_error
renewing
renew_error
xfering
xfer_error
Default: status_unknown
project_id
​google.protobuf.StringValue
organization_id
​google.protobuf.StringValue
is_external
​google.protobuf.BoolValue

List domains › Responses

200
total_count
​integer · uint32

Get domain

GET
https://api.scaleway.com
/domain/v2beta1/domains/{domain}

Retrieve a specific domain and display the domain's information.

Get domain › path Parameters

domain
​string · required

Get domain › Responses

200
domain
​string
organization_id
​string
project_id
​string
auto_renew_status
​scaleway.domain.v2beta1.Domain.FeatureStatus · enum

Status of the automatic renewal of the domain.

Enum values:
feature_status_unknown
enabling
enabled
disabling
disabled
Default: feature_status_unknown

Status of the DNSSEC configuration of the domain.

epp_code
​string[]

List of the domain's EPP codes.

expired_at
​string | null · date-time

Date of expiration of the domain. (RFC 3339 format)

updated_at
​string | null · date-time

Domain's last modification date. (RFC 3339 format)

registrar
​string
is_external
​boolean

Indicates whether Scaleway is the domain's registrar.

status
​scaleway.domain.v2beta1.Domain.Status · enum

Status of the domain.

Enum values:
status_unknown
active
creating
create_error
renewing
renew_error
xfering
xfer_error
Default: status_unknown

List of the domain's DNS zones.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's owner.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's technical contact.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's administrative contact.

​

Registration status of an external domain, if available.

​

Status of a domain, when available for transfer.

Domain's TLD information.

List of Scaleway resources linked to the domain.

Enum values:
unknown_product
vpc
pending_trade
​boolean

Indicates if a trade is ongoing.


Update a domain's contacts

PATCH
https://api.scaleway.com
/domain/v2beta1/domains/{domain}

Update contacts for a specific domain or create a new contact.
If you add the same contact for multiple roles (owner, administrative, technical), only one ID will be created and used for all of the roles.

Update a domain's contacts › path Parameters

domain
​string · required

Update a domain's contacts › Request Body

technical_contact_id
​string | null
​
administrative_contact_id
​string | null
​

Update a domain's contacts › Responses

200
domain
​string
organization_id
​string
project_id
​string
auto_renew_status
​scaleway.domain.v2beta1.Domain.FeatureStatus · enum

Status of the automatic renewal of the domain.

Enum values:
feature_status_unknown
enabling
enabled
disabling
disabled
Default: feature_status_unknown

Status of the DNSSEC configuration of the domain.

epp_code
​string[]

List of the domain's EPP codes.

expired_at
​string | null · date-time

Date of expiration of the domain. (RFC 3339 format)

updated_at
​string | null · date-time

Domain's last modification date. (RFC 3339 format)

registrar
​string
is_external
​boolean

Indicates whether Scaleway is the domain's registrar.

status
​scaleway.domain.v2beta1.Domain.Status · enum

Status of the domain.

Enum values:
status_unknown
active
creating
create_error
renewing
renew_error
xfering
xfer_error
Default: status_unknown

List of the domain's DNS zones.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's owner.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's technical contact.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's administrative contact.

​

Registration status of an external domain, if available.

​

Status of a domain, when available for transfer.

Domain's TLD information.

List of Scaleway resources linked to the domain.

Enum values:
unknown_product
vpc
pending_trade
​boolean

Indicates if a trade is ongoing.


Get a domain's authorization code

GET
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/auth-code

Retrieve the authorization code to transfer an unlocked domain. The output returns an error if the domain is locked. Some TLDs may have a different procedure to retrieve the authorization code. In that case, the information displays in the message field.

Get a domain's authorization code › path Parameters

domain
​string · required

Get a domain's authorization code › Responses


Disable auto renew

POST
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/disable-auto-renew

Disable the auto renew feature for a domain. This means the domain will not be renewed before its expiry date.

Disable auto renew › path Parameters

domain
​string · required

Disable auto renew › Request Body

Disable auto renew › Responses

200
domain
​string
organization_id
​string
project_id
​string
auto_renew_status
​scaleway.domain.v2beta1.Domain.FeatureStatus · enum

Status of the automatic renewal of the domain.

Enum values:
feature_status_unknown
enabling
enabled
disabling
disabled
Default: feature_status_unknown

Status of the DNSSEC configuration of the domain.

epp_code
​string[]

List of the domain's EPP codes.

expired_at
​string | null · date-time

Date of expiration of the domain. (RFC 3339 format)

updated_at
​string | null · date-time

Domain's last modification date. (RFC 3339 format)

registrar
​string
is_external
​boolean

Indicates whether Scaleway is the domain's registrar.

status
​scaleway.domain.v2beta1.Domain.Status · enum

Status of the domain.

Enum values:
status_unknown
active
creating
create_error
renewing
renew_error
xfering
xfer_error
Default: status_unknown

List of the domain's DNS zones.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's owner.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's technical contact.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's administrative contact.

​

Registration status of an external domain, if available.

​

Status of a domain, when available for transfer.

Domain's TLD information.

List of Scaleway resources linked to the domain.

Enum values:
unknown_product
vpc
pending_trade
​boolean

Indicates if a trade is ongoing.


Disable a domain's DNSSEC

POST
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/disable-dnssec

Disable DNSSEC for a domain.

Disable a domain's DNSSEC › path Parameters

domain
​string · required

Disable a domain's DNSSEC › Request Body

Disable a domain's DNSSEC › Responses

200
domain
​string
organization_id
​string
project_id
​string
auto_renew_status
​scaleway.domain.v2beta1.Domain.FeatureStatus · enum

Status of the automatic renewal of the domain.

Enum values:
feature_status_unknown
enabling
enabled
disabling
disabled
Default: feature_status_unknown

Status of the DNSSEC configuration of the domain.

epp_code
​string[]

List of the domain's EPP codes.

expired_at
​string | null · date-time

Date of expiration of the domain. (RFC 3339 format)

updated_at
​string | null · date-time

Domain's last modification date. (RFC 3339 format)

registrar
​string
is_external
​boolean

Indicates whether Scaleway is the domain's registrar.

status
​scaleway.domain.v2beta1.Domain.Status · enum

Status of the domain.

Enum values:
status_unknown
active
creating
create_error
renewing
renew_error
xfering
xfer_error
Default: status_unknown

List of the domain's DNS zones.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's owner.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's technical contact.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's administrative contact.

​

Registration status of an external domain, if available.

​

Status of a domain, when available for transfer.

Domain's TLD information.

List of Scaleway resources linked to the domain.

Enum values:
unknown_product
vpc
pending_trade
​boolean

Indicates if a trade is ongoing.


Enable auto renew

POST
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/enable-auto-renew

Enable the auto renew feature for a domain. This means the domain will be automatically renewed before its expiry date.

Enable auto renew › path Parameters

domain
​string · required

Enable auto renew › Request Body

Enable auto renew › Responses

200
domain
​string
organization_id
​string
project_id
​string
auto_renew_status
​scaleway.domain.v2beta1.Domain.FeatureStatus · enum

Status of the automatic renewal of the domain.

Enum values:
feature_status_unknown
enabling
enabled
disabling
disabled
Default: feature_status_unknown

Status of the DNSSEC configuration of the domain.

epp_code
​string[]

List of the domain's EPP codes.

expired_at
​string | null · date-time

Date of expiration of the domain. (RFC 3339 format)

updated_at
​string | null · date-time

Domain's last modification date. (RFC 3339 format)

registrar
​string
is_external
​boolean

Indicates whether Scaleway is the domain's registrar.

status
​scaleway.domain.v2beta1.Domain.Status · enum

Status of the domain.

Enum values:
status_unknown
active
creating
create_error
renewing
renew_error
xfering
xfer_error
Default: status_unknown

List of the domain's DNS zones.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's owner.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's technical contact.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's administrative contact.

​

Registration status of an external domain, if available.

​

Status of a domain, when available for transfer.

Domain's TLD information.

List of Scaleway resources linked to the domain.

Enum values:
unknown_product
vpc
pending_trade
​boolean

Indicates if a trade is ongoing.


Update domain DNSSEC

POST
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/enable-dnssec

If your domain uses another registrar and has the default Scaleway NS, you have to update the DS record at your registrar.

Update domain DNSSEC › path Parameters

domain
​string · required

Update domain DNSSEC › Request Body

Update domain DNSSEC › Responses

200
domain
​string
organization_id
​string
project_id
​string
auto_renew_status
​scaleway.domain.v2beta1.Domain.FeatureStatus · enum

Status of the automatic renewal of the domain.

Enum values:
feature_status_unknown
enabling
enabled
disabling
disabled
Default: feature_status_unknown

Status of the DNSSEC configuration of the domain.

epp_code
​string[]

List of the domain's EPP codes.

expired_at
​string | null · date-time

Date of expiration of the domain. (RFC 3339 format)

updated_at
​string | null · date-time

Domain's last modification date. (RFC 3339 format)

registrar
​string
is_external
​boolean

Indicates whether Scaleway is the domain's registrar.

status
​scaleway.domain.v2beta1.Domain.Status · enum

Status of the domain.

Enum values:
status_unknown
active
creating
create_error
renewing
renew_error
xfering
xfer_error
Default: status_unknown

List of the domain's DNS zones.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's owner.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's technical contact.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's administrative contact.

​

Registration status of an external domain, if available.

​

Status of a domain, when available for transfer.

Domain's TLD information.

List of Scaleway resources linked to the domain.

Enum values:
unknown_product
vpc
pending_trade
​boolean

Indicates if a trade is ongoing.


List a domain's hostnames

GET
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/hosts

List a domain's hostnames using their glue IPs.

List a domain's hostnames › path Parameters

domain
​string · required

List a domain's hostnames › query Parameters

page
​google.protobuf.Int32Value · int32
page_size
​integer · uint32

List a domain's hostnames › Responses

200
total_count
​integer · uint32

Create a hostname for a domain

POST
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/hosts

Create a hostname for a domain with glue IPs.

Create a hostname for a domain › path Parameters

domain
​string · required

Create a hostname for a domain › Request Body

name
​string
ips
​string[]

(IP address)

Create a hostname for a domain › Responses

200
domain
​string
name
​string
ips
​string[]

(IP address)

status
​scaleway.domain.v2beta1.Host.Status · enum
Enum values:
unknown_status
active
updating
deleting
Default: unknown_status

Delete a domain's hostname

DELETE
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/hosts/{name}

Delete a domain's hostname › path Parameters

domain
​string · required
name
​string · required

Delete a domain's hostname › Responses

200
domain
​string
name
​string
ips
​string[]

(IP address)

status
​scaleway.domain.v2beta1.Host.Status · enum
Enum values:
unknown_status
active
updating
deleting
Default: unknown_status

Update a domain's hostname

PATCH
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/hosts/{name}

Update a domain's hostname with glue IPs.

Update a domain's hostname › path Parameters

domain
​string · required
name
​string · required

Update a domain's hostname › Request Body

Update a domain's hostname › Responses

200
domain
​string
name
​string
ips
​string[]

(IP address)

status
​scaleway.domain.v2beta1.Host.Status · enum
Enum values:
unknown_status
active
updating
deleting
Default: unknown_status

Lock the transfer of a domain

POST
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/lock-transfer

Lock the transfer of a domain. This means that the domain cannot be transferred and the authorization code cannot be requested to your current registrar.

Lock the transfer of a domain › path Parameters

domain
​string · required

Lock the transfer of a domain › Request Body

Lock the transfer of a domain › Responses

200
domain
​string
organization_id
​string
project_id
​string
auto_renew_status
​scaleway.domain.v2beta1.Domain.FeatureStatus · enum

Status of the automatic renewal of the domain.

Enum values:
feature_status_unknown
enabling
enabled
disabling
disabled
Default: feature_status_unknown

Status of the DNSSEC configuration of the domain.

epp_code
​string[]

List of the domain's EPP codes.

expired_at
​string | null · date-time

Date of expiration of the domain. (RFC 3339 format)

updated_at
​string | null · date-time

Domain's last modification date. (RFC 3339 format)

registrar
​string
is_external
​boolean

Indicates whether Scaleway is the domain's registrar.

status
​scaleway.domain.v2beta1.Domain.Status · enum

Status of the domain.

Enum values:
status_unknown
active
creating
create_error
renewing
renew_error
xfering
xfer_error
Default: status_unknown

List of the domain's DNS zones.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's owner.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's technical contact.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's administrative contact.

​

Registration status of an external domain, if available.

​

Status of a domain, when available for transfer.

Domain's TLD information.

List of Scaleway resources linked to the domain.

Enum values:
unknown_product
vpc
pending_trade
​boolean

Indicates if a trade is ongoing.


Unlock the transfer of a domain

POST
https://api.scaleway.com
/domain/v2beta1/domains/{domain}/unlock-transfer

Unlock the transfer of a domain. This means that the domain can be transferred and the authorization code can be requested to your current registrar.

Unlock the transfer of a domain › path Parameters

domain
​string · required

Unlock the transfer of a domain › Request Body

Unlock the transfer of a domain › Responses

200
domain
​string
organization_id
​string
project_id
​string
auto_renew_status
​scaleway.domain.v2beta1.Domain.FeatureStatus · enum

Status of the automatic renewal of the domain.

Enum values:
feature_status_unknown
enabling
enabled
disabling
disabled
Default: feature_status_unknown

Status of the DNSSEC configuration of the domain.

epp_code
​string[]

List of the domain's EPP codes.

expired_at
​string | null · date-time

Date of expiration of the domain. (RFC 3339 format)

updated_at
​string | null · date-time

Domain's last modification date. (RFC 3339 format)

registrar
​string
is_external
​boolean

Indicates whether Scaleway is the domain's registrar.

status
​scaleway.domain.v2beta1.Domain.Status · enum

Status of the domain.

Enum values:
status_unknown
active
creating
create_error
renewing
renew_error
xfering
xfer_error
Default: status_unknown

List of the domain's DNS zones.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's owner.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's technical contact.

​scaleway.domain.v2beta1.Contact

Contact information of the domain's administrative contact.

​

Registration status of an external domain, if available.

​

Status of a domain, when available for transfer.

Domain's TLD information.

List of Scaleway resources linked to the domain.

Enum values:
unknown_product
vpc
pending_trade
​boolean

Indicates if a trade is ongoing.


List domains that can be renewed

GET
https://api.scaleway.com
/domain/v2beta1/renewable-domains

Retrieve the list of domains you own that can be renewed. You can also see the maximum renewal duration in years for your domains that are renewable.

List domains that can be renewed › query Parameters

page
​google.protobuf.Int32Value · int32
page_size
​integer · uint32
Enum values:
domain_asc
domain_desc
Default: domain_asc
project_id
​google.protobuf.StringValue
organization_id
​google.protobuf.StringValue

List domains that can be renewed › Responses

200

Search available domains

GET
https://api.scaleway.com
/domain/v2beta1/search-domains

Search a domain or a maximum of 10 domains that are available.

If the TLD list is empty or not set, the search returns the results from the most popular TLDs.

Search available domains › query Parameters

domains
​string[] · required

A list of domain to search, TLD is optional.

strict_search
​boolean · required

Search exact match.

include_exact_match
​boolean · required

If an exact match is found, include it in response as a separate element.

tlds
​string[]

Array of tlds to search on.

Search available domains › Responses

200

Array of available domains.

​scaleway.domain.v2beta1.AvailableDomain

If an exact match was asked and found, the result is in this field.


List TLD offers

GET
https://api.scaleway.com
/domain/v2beta1/tlds

Retrieve the list of TLDs and offers associated with them.

List TLD offers › query Parameters

tlds
​string[]

Array of TLDs to return.

page
​integer · int32

Page number for the returned Projects.

page_size
​integer · uint32

Maximum number of Project per page.

order_by
​scaleway.domain.v2beta1.ListTldsRequest.OrderBy · enum

Sort order of the returned TLDs.

Enum values:
name_asc
name_desc
Default: name_asc

List TLD offers › Responses

200

Array of TLDs.

total_count
​integer · uint64

Total count of TLDs returned.