---
title: "Domain Status Update"
url: "https://help.internetx.com/de/api/core-domain-status-update/"
lang: "de"
section: "API-Referenz — API-Referenz (XML/JSON)"
breadcrumb: "API-Dokumentation (XML/ JSON) > Auftragstypen > Transfer-Auftragstypen"
updated: "2023-09-07"
---

# Domain Status Update

## Funktion

Der Auftragstyp _DomainStatusUpdate_ setzt den Status einer Domain. So kannst du die Domain vor Transfers schützen. Dies ist nur für gTLDs möglich. Beachte, dass die Registrys z. T. nicht alle Status unterstützen.

Die möglichen Status sind im Enum [RegistryStatusConstants](/de/api/core-registrystatusconstants/) hinterlegt.  

## Beschreibung

Route: PUT /domain/{name}/\_statusUpdate  

```
{ "registryStatus": "LOCK" }
```

```
{ "status" : { "code" : "N0102002", "text" : "Die Aktualisierung des Domain-Status wurde erfolgreich gestartet.", "type" : "NOTIFY" }, "object" : { "type" : "Domain", "value" : "example.com" }, "data" : [ { "owner" : { "context" : 4, "user" : "customer" }, "updater" : { "context" : 4, "user" : "customer" }, "execution" : "2020-06-29T11:39:25.823+0200", "id" : 2697604 } ] }
```

Auftragstyp-Code: 0102002  
Verwendet Objekt [Domain](/de/api/core-objekt-domain/)

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0102002</code>
		<domain>
			<name>example.com</name>
			<registry_status>ACTIVE</registry_status>
		</domain>
		<reply_to>customer@example.com</reply_to>
		<ctid>aöslkdjf</ctid>
	</task>
</request>
```

```
<response>
	<result>
		<data>
			<domain_job>
				<job>
					<id>673402</id>
				</job>
			</domain_job>
		</data>
		<status>
			<code>N0102002</code>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.com</value>
			</object>
		</status>
	</result>
</response>
```