Domains

Check Domain Availability

Checks whether your desired domains are still available. You can check up to 30 domains in a single request. Returns the status (Available, NotAvailable, Premium, etc.) as well as pricing information.

URL: POST /api/v1/organizations/{organizationId}/domains/availability

Request Body:

{
  "domainNames": ["ihre-wunschdomain.de", "beispiel.at"]
}

Example Response (200 OK):

[
  {
    "domainName": "ihre-wunschdomain.de",
    "availability": "Available",
    "price": 12.5,
    "setupServicePrice": 0.0,
    "isAvailableForRealTimeOrder": true
  }
]

Order Domain

Places a binding order for a domain. Important: You need a valid contactHandleId and nameserverSetId.

URL: POST /api/v1/organizations/{organizationId}/domains

Request Body:

{
  "domainName": "ihre-wunschdomain.de",
  "contactHandleId": "e40695fd-b244-4544-bf5f-afd1745a3e5d",
  "nameserverSetId": "2e7fcfc8-ea2b-466b-8fda-b3d0770452fd",
  "isTrusteeServiceOrdered": false,
  "isIcpServiceOrdered": false,
  "isTermsConditionsAccepted": true
}

Example Response (200 OK):

{
  "domainId": "e6836361-98e3-45c4-9706-c5519b10f27c",
  "domainName": "ihre-wunschdomain.de",
  "status": "requested",
  "orderDate": "2026-01-28T09:30Z"
}

Get Domains

Lists all domains belonging to your organization.

URL: GET /api/v1/organizations/{organizationId}/domains

Example Response (200 OK):

[
  {
    "domainId": "e6836361-98e3-45c4-9706-c5519b10f27c",
    "domainName": "domain.de",
    "status": "active",
    "registrationDate": "2025-05-10T09:30Z"
  }
]

Get Domain WHOIS

Retrieves the registration data. There are two variants:

1. Own domain: Details via ID (GET /api/v1/organizations/{organizationId}/domains/{domainId}/public-whois).
2. Any domain: Search via name (GET /api/v1/organizations/{organizationId}/domains/public-whois?domainName=stackit.de).

Example Response (200 OK):

{
  "domainName": "stackit.de",
  "host": "whois.denic.de",
  "whoIsInformation": "Domain: stackit.de\nStatus: connect\nChanged: 2025-04-07T12:17:41+02:00"
}

Domain Status Values

• active: The domain is successfully registered and active.
• requested: The registration process has been initiated.
• pending: Manual processing by the registry team is required.