---
title: "Domain buy order"
url: "https://help.internetx.com/en/api/core-domain-buy-order/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks > Domain tasks"
updated: "2023-09-18"
---

# Domain buy order

## Function

With this task, a domain can be purchased via an external sales platform. 

The keywords of the "Domain" element are described on the [Domain](/en/api/core-domain-object/) object HelpCenter page. The keywords of the domain contact elements (ownerc, adminc, techc, zonec) for  [DomainCreatePlus](/en/api/core-domain-create-plus/) are described on the [Contact](/en/api/core-contact-object/) object HelpCenter page.  

## Description

Route: POST /domain/\_buy  

```
{
  "name": "example.com",
  "nameServers": [
    {
      "name": "ns1.example.com"
    },
    {
      "name": "ns2.example.com"
    }
  ],
  "ownerc": {
    "id": 15533046
  },
  "adminc": {
    "id": 15533046
  },
  "techc": {
    "id": 15533046
  },
  "zonec": {
    "id": 15533046
  },
  "extensions": {
    "domainBuyExtensions": {
       "amount": "9.0",
       "currency": "EUR"
    }
  }
}
```

```
{
  "status": {
    "code": "N0101006",
    "text": "N0101006",
    "type": "NOTIFY"
  },
  "object": {
    "type": "Domain",
    "value": "example.com"
  }
}
```

Task code: 0101006  
Uses  [Domain](/de/api/core-objekt-domain/)  object

```
<request>
	<auth>
		<user>customer</user>
		<password>passwort</password>
		<context>4</context>
	</auth>
	<task>
		<code>0101006</code>
		<domain>
			<name>example.com</name>
			<ownerc>21653083</ownerc>
			<techc>21653083</techc>
			<adminc>21653083</adminc>
			<zonec>21653083</zonec>
			<nserver>
				<name>ns1.example.de</name>
			</nserver>
			<nserver>
				<name>ns2.example.de</name>
			</nserver>
			<extension>
				<purchase_price>10.0</purchase_price>
				<purchase_price_currency>EUR</purchase_price_currency>
			</extension>
		</domain>
	</task>
</request>
```

```
<response>
	<result>
		<msg>
			<code>S0301</code>
			<type>success</type>
			<msg>
				<code>MSG03003</code>
				<type>notice</type>
			</msg>
			<object>
				<type>handle</type>
				<value>2693</value>
			</object>
		</msg>
		<status>
			<code>N0101006</code>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.com</value>
			</object>
		</status>
	</result>
</response>
```