Skip to main content
POST
Ausgehenden Transfer bestätigen

Authorizations

Authorization
string
header
required

Access-Token aus POST /auth/login (E-Mail und Passwort), gesendet als Authorization: Bearer <token>.

Das Token ist zeitlich begrenzt gültig. Mit dem refresh_token aus derselben Antwort holt POST /auth/token/refresh ein neues Token-Paar, ohne das Passwort erneut zu senden; POST /auth/token/invalidate macht den Refresh-Token beim Abmelden ungültig.

Ist für das Konto ein zweiter Faktor aktiv oder vorgeschrieben, liefert der Login statt des Token-Paars mfaRequired: true bzw. mfaEnrollmentRequired: true und ein kurzlebiges preAuthToken. Mit diesem Token (ebenfalls als Bearer) wird der zweite Faktor über POST /auth/2fa/verify bestätigt; erst danach gibt es das volle Token-Paar.

Headers

X-Customer-Id
string

Optionaler Kundenkontext. Ohne Header arbeitet die Anfrage im Standard-Kunden des angemeldeten Benutzers. Mit der ID eines anderen Kunden handelt die Anfrage in dessen Kontext: Listen, Lese- und Schreibzugriffe beziehen sich dann auf diesen Kunden.

Erlaubt sind der eigene Kunde, jeder Unterkunde im eigenen Teilbaum (Reseller handelt für seinen Endkunden) sowie Kunden, in denen der Benutzer selbst Mitglied ist. Übergeordnete oder fremde Kunden werden mit 403 Forbidden abgewiesen, eine unbekannte ID ebenfalls.

Die IDs der erreichbaren Kunden liefern GET /user/customers und GET /customers/{id}/children.

Example:

"01JD4Q8W3N6Y2K5T7R9V0B1C2D"

Path Parameters

id
string
required

Domain identifier

Response

Domain resource created

id
string
read-only
Example:

"A1B2C3D4E5F6G7H8I9J0"

name
string
read-only

A partial unique index (uniq_domain_name_active, see Version20260707100001 / Version20260831230000) enforces uniqueness of the name across active states so two concurrent orders cannot both create an active record for the same name. Terminal or reorderable states (DELETED, TRANSFERED_OUT, FAILED_REGISTRATION, FAILED_TRANSFER) are excluded — a failed order position must not block the name forever.

Example:

"example.com"

adminHandle
object | null
techHandle
object | null
ownerHandle
object | null
zoneHandle
object | null
isDomainTransferLocked
boolean
read-only
Example:

true

isAutoRenewEnabled
boolean
read-only
Example:

true

registrationDate
string<date-time>
read-only
Example:

"2021-01-01T00:00:00+00:00"

expiresAt
string<date-time> | null
read-only

Real registrar expiry date (paid-until), synced from the registrar status data.

Example:

"2022-01-01T00:00:00+00:00"

status
enum<string>
deprecated
read-only
Available options:
created,
pending,
pendingRegistration,
pendingTransfer,
pendingTransferOut,
online,
deleted,
pendingDelete,
failedNameserver,
failedRegistration,
failedTransfer,
unknown,
transferedOut,
transit,
pendingTransit,
zoneCreated
Example:

"online"

lifecycleStatus
enum<string> | null
read-only

Lebenszyklus-Status des neuen Modells — genau einer je Domain.

Available options:
draft,
pendingRegistration,
pendingTransferIn,
active,
suspended,
expired,
redemption,
pendingDelete,
deleted,
pendingTransferOut,
transferredOut,
transit,
failed,
attention
Example:

"active"

statusReason
enum<string> | null
read-only

Pflichtgrund bei SUSPENDED/FAILED/ATTENTION, sonst optional.

Available options:
abuseHold,
verificationPending,
paymentHold,
registryHold,
registrarHold,
nsFailed,
registrationRejected,
transferRejected,
expiredNoRenewal,
restorePending,
customerCanceled,
registryDeleted,
unmappedRegistrarStatus,
unexpectedTransition,
notInRegistrarAccount,
expiryUnresolved,
deleteFailedAtRegistrar,
renewFailedAtRegistrar,
eventContradictsRegistrar,
reconcileDeadlineExceeded
Example:

"nsFailed"

flags
enum<string>[]
read-only

Registry-/Registrar-Eigenschaften, die NIE den Status ändern (Sperren, Auto-Renew, laufende Updates, DNSSEC, Claims). Als Werte von {@see DomainFlag} gespeichert.

Available options:
transferLock,
updateLock,
deleteLock,
renewLock,
autoRenew,
pendingUpdate,
pendingRenew,
dnssec,
claims
Example:
nameservers
object[]
read-only
priceClass
string | null

Premium price class used at registration (e.g. "ABOGADO-TIER-500").

zone
string<iri-reference> | null
read-only
Example:

"https://example.com/"

transitType
enum<string> | null
read-only
Available options:
connected,
disconnected,
null
Example:

"connected"

transitAt
string<date-time> | null
read-only
Example:

"2021-01-01T00:00:00+00:00"

canceledAt
string<date-time> | null
read-only
Example:

"2021-01-01T00:00:00+00:00"

transferOutDeadlineAt
string<date-time> | null
read-only

Entscheidungsfrist einer laufenden, FREMD-initiierten Transfer-Anfrage (Status pendingTransferOut): Zeitpunkt, zu dem die Registry ohne ACK/NACK automatisch bestätigt (TldPolicy::$transferOutAckDeadlineDays). Persistiert, weil das Panel den Countdown zeigt und der Timer-Workflow damit gestartet wird; wird mit der Kundenentscheidung bzw. dem Abschluss des Transfers wieder geleert.

Example:

"2021-01-01T00:00:00+00:00"

isTransferIn
boolean
default:false
read-only
Example:

true

paidAt
string<date-time> | null
read-only

Zahlungseingang DIESER Bestellposition (ARC-151 §P1).

promisedRenewGross
integer | null
read-only

Brutto-Gegenstück zu {@see $promisedRenewNet} in Cent.

premiumAcknowledgedAt
string<date-time> | null
read-only

Zeitpunkt der ausdrücklichen Kundenbestätigung des Premium-Preises (inkl.

premiumQuoteExpiresAt
string<date-time> | null

Ablauf des Premium-Angebots aus dem Anfragepfad. Danach ist die Anfrage geschlossen; registriert oder berechnet wurde bis dahin nichts.

delegationCheckStatus
enum<string> | null
read-only

Ergebnis der letzten Delegationsprüfung (ARC-163, openspec: update-domain-delegation-nast-check).

Available options:
ok,
warning,
unknown
Example:

"warning"

delegationCheckFindings
object | null
read-only

Die Befunde der letzten Prüfung ({@see DelegationCheckResult::toArray()}).

delegationCheckedAt
string<date-time> | null
read-only
Example:

"2026-09-21T10:00:00+00:00"

sandbox
boolean
read-only

Read-only: order belongs to a test account and runs against sandbox registrars

Example:

false

displayStatus
string
read-only

Kundentext zum Status („Aktiv", „Angehalten", „Wird geprüft") — keine Registrar-Begriffe.

Example:

"Aktiv"

displayReason
string | null
read-only

Kundentext zum Grund; null, wenn der Status für sich spricht.

Example:

"Kontaktverifikation ausstehend"

nextAction
enum<string>
read-only

Handlungsaufforderung für den Kunden (Panel-Button, Mail-CTA).

Available options:
none,
wait,
renew,
restore,
verifyContact,
confirmTransferOut,
fixNameservers,
revokeCancellation,
payInvoice,
retryOrder,
registerAgain,
contactSupport
Example:

"none"

statusSeverity
string
read-only

info | warning | critical — steuert die Badge-Farbe im Panel.

Example:

"info"

dnsZoneId
string | null
read-only
Example:

"A1234567"