Domains and DNS - Registrar API
​string[]​string[]​string​string​string
​google.protobuf.Int32Value · int32​integer · uint32​google.protobuf.StringValue​google.protobuf.StringValue​google.protobuf.StringValue​scaleway.domain.v2beta1.ListContactsRequest.Role · enum​scaleway.domain.v2beta1.Contact.EmailStatus · enum​integer · uint32
​string · required​string​scaleway.domain.v2beta1.Contact.LegalForm · enum​string​string​string​string​string​string​string​string​string​string​string​string​string​string​scaleway.std.LanguageCode · enum​boolean​boolean​scaleway.domain.v2beta1.Contact.EmailStatus · enum​string​scaleway.domain.v2beta1.Contact.Status · enum
​string · required​google.protobuf.StringValue​google.protobuf.StringValue​google.protobuf.StringValue​google.protobuf.StringValue​google.protobuf.StringValue​google.protobuf.StringValue​google.protobuf.StringValue​google.protobuf.StringValue​google.protobuf.StringValue​google.protobuf.StringValue​scaleway.std.LanguageCode · enum​google.protobuf.BoolValue​google.protobuf.BoolValue​google.protobuf.StringValue​string​scaleway.domain.v2beta1.Contact.LegalForm · enum​string​string​string​string​string​string​string​string​string​string​string​string​string​string​scaleway.std.LanguageCode · enum​boolean​boolean​scaleway.domain.v2beta1.Contact.EmailStatus · enum​string​scaleway.domain.v2beta1.Contact.Status · enum
There are up to three different types of contacts for a domain: Owner: The owner is the registrant and owner of the domain. Administrative: The administrative contact of a domain is typically in charge of performing all domain-related actions. Technical: The technical contact of a domain takes care of technical issues like DNS records.
It is possible to be the Owner and the Administrative and / or the Technical contact all at once but some registries may have specific requirements.
Check if contacts are compatible with a domain or a TLD
POST
https://api.scaleway.com
/domain/v2beta1/check-contacts-compatibility
Check whether contacts are compatible with a domain or a TLD. If contacts are not compatible with either the domain or the TLD, the information that needs to be corrected is returned.
Check if contacts are compatible with a domain or a TLD › Request Body
domainstldsowner_contact_id​object
administrative_contact_id​object
technical_contact_id​object
Check if contacts are compatible with a domain or a TLD › Responses
200
List contacts
GET
https://api.scaleway.com
/domain/v2beta1/contacts
Retrieve the list of contacts and their associated domains and roles. You can filter the list by domain name.
query Parameters
pagepage_sizedomainproject_idorganization_idroleEnum values:
unknown_role
owner
administrative
technical
Default: unknown_role
email_statusEnum values:
email_status_unknown
validated
not_validated
invalid_email
Default: email_status_unknown
List contacts › Responses
200
total_countGet a contact
GET
https://api.scaleway.com
/domain/v2beta1/contacts/{contact_id}
Retrieve a contact's details from the registrar using the given contact's ID.
path Parameters
contact_idGet a contact › Responses
200
idlegal_formEnum values:
legal_form_unknown
individual
corporate
association
other
Default: legal_form_unknown
firstnamelastnamecompany_nameemailemail_altphone_numberfax_numberaddress_line_1address_line_2zipcitycountryvat_identification_codecompany_identification_codelangEnum values:
unknown_language_code
en_US
fr_FR
de_DE
Default: unknown_language_code
resalewhois_opt_inemail_statusEnum values:
email_status_unknown
validated
not_validated
invalid_email
Default: email_status_unknown
statestatusEnum values:
status_unknown
active
pending
Default: status_unknown
​scaleway.domain.v2beta1.Contact.Question[] · deprecated
Update contact
PATCH
https://api.scaleway.com
/domain/v2beta1/contacts/{contact_id}
Edit the contact's information.
path Parameters
contact_idUpdate contact › Request Body
emailemail_altphone_numberfax_numberaddress_line_1address_line_2citycountryvat_identification_codecompany_identification_codelangEnum values:
unknown_language_code
en_US
fr_FR
de_DE
Default: unknown_language_code
resalewhois_opt_instate​scaleway.domain.v2beta1.UpdateContactRequest.Question[] · deprecated
Update contact › Responses
200
idlegal_formEnum values:
legal_form_unknown
individual
corporate
association
other
Default: legal_form_unknown
firstnamelastnamecompany_nameemailemail_altphone_numberfax_numberaddress_line_1address_line_2zipcitycountryvat_identification_codecompany_identification_codelangEnum values:
unknown_language_code
en_US
fr_FR
de_DE
Default: unknown_language_code
resalewhois_opt_inemail_statusEnum values:
email_status_unknown
validated
not_validated
invalid_email
Default: email_status_unknown
statestatusEnum values:
status_unknown
active
pending
Default: status_unknown
​scaleway.domain.v2beta1.Contact.Question[] · deprecated