22 Domains API: How to trade a domain

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.

Entering Geo Fence iconUse 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 realtime domain transfer

Was this article helpful?
0 out of 0 found this helpful