22 Domains API: How to trade a domain
This is a series of articles dedicated to demonstrating how to get get acquainted with Openprovider Domains API methods.To get more information about our API in general, please use ourdocumentation portalas your reference.
Domain trade is a procedure of changing the current owner of a domain name. Some TLDs allow you to change the owner of a domain name by switching thehandle attribute.
Others, however, do not allow you to explicitly change the owner, a special procedure is required in these cases. You can initiate this procedure either by navigating toTradepage in our control panel or by by utilising Trade Domain method.
Use endpoint path below. Base URL is determined by both the target environment and API version.POST{base_url}/domains/trade
REQUEST VALUES
| Name | Type | Description |
| domain | string | Required. |
| period | integer | Required. |
| authcode | varchar | Optional. |
| owner_handle | varchar | Required. |
| admin_handle | varchar | Required. |
| tech_handle | varchar | Required. |
| billing_handle | varchar | Optional. |
| reseller_handle | varchar | Optional. |
| ns_group | string | Required. |
| ns_template_name | string | Optional. Name of the template to use to automatically create DNS zone for the domain; only applicable if nsGroup |
| name_servers | dot separated integer |
Required |
| autorenew | custom | on | off | default |
| is_dnssec_enabled | boolean | 0 (default) or 1 - Only accepted when nameservers of Openprovider are used |
| dnssec_keys | varchar | when using your own nameservers |
| use_domicile | boolean | 0 or 1 |
| at | timestamp | format: yyyy-mm-dd |
| promo_code | Optional. | |
| accept_premium_fee |
required in case when domain is premium, value is the price returned in the response for transferDomainRequest without acceptPremiumFee. |
REQUEST EXAMPLE
RESPONSE EXAMPLE
RESPONSE VALUES
| Name | Type | Description |
| expiration_date | timestamp | available only in case of a successful real time domain transfer |