This is a series of articles dedicated to demonstrating how to get acquainted with Openprovider Domains API methods.To get more information about our API in general, please use our documentation portal as 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 the handle 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 to Trade page in our control panel or 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 is dns-openprovider |
| name_servers | dot separated integer | Required if only if nsGroup field is empty |
| 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↓
curl -X POST \
'http://api.openprovider.eu/v1beta/domains/trade' \
-H 'Accept: */*' \
-H 'Authorization: ,Bearer 2f4c1c3a9******15d22b378a64' \
-H 'Connection: keep-alive' \
-H 'Content-Type: application/json' \
-d '{
"admin_handle": "XX123456-XX",
"auth_code": "gX38tslFG2#%F%%1",
"autorenew": "default",
"domain": {
"extension": "com",
"name": "domain",
},
"ns_group": "dns-openprovider",
"owner_handle": "RB919364-BE",
"period": 1,
"tech_handle": "XX123456-XX",
}
RESPONSE EXAMPLE↓
{
"code": 0,
"data": {
"creation_date": "2019-04-12 07:28:27",
"expiration_date": "2020-04-16 13:18:54",
"renewal_date": "2020-04-16 13:18:54",
"status": "ACT"
},
"desc": ""
}
RESPONSE VALUES↓
| Name | Type | Description |
| expiration_date | timestamp | available only in case of a successful real time domain transfer |
