List Domains

GET/domains/

API version

v2

Request method

GET

Operation ID

domain-list-domains

---

Request

Responses

Format

application/json

Description

OK

Schema documentation

• Array[
• *object
  • authCodeobject
    • expiresstring (date-time)
    • valuestring

      required
  • authCode2object
    • expiresstring (date-time)

      required
  • connectedboolean

    required
  • contactHashstring
  • deletedboolean

    required
  • domainstring (naked-domain)

    required
  • domainIdstring (uuid)

    required
  • handlesobject

    required
    • adminCobject
      • currentobject

        required
        • handleFieldsarray of object
          • Array[
          • *object
            • namestring

              required
            • valuestring

              required
          ]
        • handleRefstring
      • desiredobject
        • handleFieldsarray of object
          • Array[
          • *object
            • namestring

              required
            • valuestring

              required
          ]
        • handleRefstring
    • ownerCobject

      required
      • currentobject

        required
        • handleFieldsarray of object
          • Array[
          • *object
            • namestring

              required
            • valuestring

              required
          ]
        • handleRefstring
      • desiredobject
        • handleFieldsarray of object
          • Array[
          • *object
            • namestring

              required
            • valuestring

              required
          ]
        • handleRefstring
  • nameserversarray of string (idn-hostname)

    required
    • Array[
    • *string (idn-hostname)
    ]
  • processesarray of object
    • Array[
    • *object
      • errorstring
      • lastUpdatestring (date-time)

        required
      • processTypestring (one of: UNSPECIFIED, REGISTER, TRANSFER, DELETE, TRANSIT, RESTORE, UPDATE, TRANSFER_OUT, OWNER_CHANGE, DECLARE_REQUESTED)

        required
      • statestring (one of: UNSPECIFIED, REQUESTED, FAILED)

        required
      • statusstring
      • statusCodestring
      • transactionIdstring

        required
    ]
  • projectIdstring (uuid)

    required
  • transferInAuthCodestring
  • usesDefaultNameserverboolean

    required
]

Example

[
  {
    "authCode": {
      "expires": "2025-04-27T14:56:16.692Z",
      "value": "string"
    },
    "authCode2": {
      "expires": "2025-04-27T14:56:16.692Z"
    },
    "connected": true,
    "contactHash": "string",
    "deleted": true,
    "domain": "string",
    "domainId": "f0f86186-0a5a-45b2-aa33-502777496347",
    "handles": {
      "adminC": {
        "current": {
          "handleFields": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "handleRef": "string"
        },
        "desired": {
          "handleFields": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "handleRef": "string"
        }
      },
      "ownerC": {
        "current": {
          "handleFields": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "handleRef": "string"
        },
        "desired": {
          "handleFields": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "handleRef": "string"
        }
      }
    },
    "nameservers": [
      "some-hostname.example"
    ],
    "processes": [
      {
        "error": "string",
        "lastUpdate": "2025-04-27T14:56:16.692Z",
        "processType": "UNSPECIFIED",
        "state": "UNSPECIFIED",
        "status": "string",
        "statusCode": "string",
        "transactionId": "string"
      }
    ],
    "projectId": "f0f86186-0a5a-45b2-aa33-502777496347",
    "transferInAuthCode": "string",
    "usesDefaultNameserver": true
  }
]

JSON Schema

{
  "items": {
    "properties": {
      "authCode": {
        "properties": {
          "expires": {
            "format": "date-time",
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "value"
        ],
        "type": "object"
      },
      "authCode2": {
        "properties": {
          "expires": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "expires"
        ],
        "type": "object"
      },
      "connected": {
        "type": "boolean"
      },
      "contactHash": {
        "type": "string"
      },
      "deleted": {
        "type": "boolean"
      },
      "domain": {
        "format": "naked-domain",
        "type": "string"
      },
      "domainId": {
        "format": "uuid",
        "type": "string"
      },
      "handles": {
        "properties": {
          "adminC": {
            "properties": {
              "current": {
                "properties": {
                  "handleFields": {
                    "items": {
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "value": {
                          "pattern": "^[0-9a-zA-ZÀ-ÖØ-öø-ÿ /&()+,.@_-]+$",
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "value"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "handleRef": {
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "desired": {
                "properties": {
                  "handleFields": {
                    "items": {
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "value": {
                          "pattern": "^[0-9a-zA-ZÀ-ÖØ-öø-ÿ /&()+,.@_-]+$",
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "value"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "handleRef": {
                    "type": "string"
                  }
                },
                "type": "object"
              }
            },
            "required": [
              "current"
            ],
            "type": "object"
          },
          "ownerC": {
            "properties": {
              "current": {
                "properties": {
                  "handleFields": {
                    "items": {
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "value": {
                          "pattern": "^[0-9a-zA-ZÀ-ÖØ-öø-ÿ /&()+,.@_-]+$",
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "value"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "handleRef": {
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "desired": {
                "properties": {
                  "handleFields": {
                    "items": {
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "value": {
                          "pattern": "^[0-9a-zA-ZÀ-ÖØ-öø-ÿ /&()+,.@_-]+$",
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "value"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "handleRef": {
                    "type": "string"
                  }
                },
                "type": "object"
              }
            },
            "required": [
              "current"
            ],
            "type": "object"
          }
        },
        "required": [
          "ownerC"
        ],
        "type": "object"
      },
      "nameservers": {
        "items": {
          "format": "idn-hostname",
          "type": "string"
        },
        "type": "array",
        "uniqueItems": true
      },
      "processes": {
        "items": {
          "properties": {
            "error": {
              "type": "string"
            },
            "lastUpdate": {
              "format": "date-time",
              "type": "string"
            },
            "processType": {
              "enum": [
                "UNSPECIFIED",
                "REGISTER",
                "TRANSFER",
                "DELETE",
                "TRANSIT",
                "RESTORE",
                "UPDATE",
                "TRANSFER_OUT",
                "OWNER_CHANGE",
                "DECLARE_REQUESTED"
              ],
              "type": "string"
            },
            "state": {
              "enum": [
                "UNSPECIFIED",
                "REQUESTED",
                "FAILED"
              ],
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "statusCode": {
              "type": "string"
            },
            "transactionId": {
              "type": "string"
            }
          },
          "required": [
            "transactionId",
            "processType",
            "state",
            "lastUpdate"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "projectId": {
        "format": "uuid",
        "type": "string"
      },
      "transferInAuthCode": {
        "type": "string"
      },
      "usesDefaultNameserver": {
        "type": "boolean"
      }
    },
    "required": [
      "domainId",
      "domain",
      "projectId",
      "deleted",
      "nameservers",
      "handles",
      "connected",
      "usesDefaultNameserver",
      "hasAuthCode"
    ],
    "type": "object"
  },
  "type": "array"
}

Usage examples

cURL

$ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v2/domains?projectId=f0f86186-0a5a-45b2-aa33-502777496347&page=1&limit=50&domainSearchName=string&contactHash=string

JavaScript SDK

import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";
  
const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.domain.listDomains({
  "queryParameters": {
    "projectId": "f0f86186-0a5a-45b2-aa33-502777496347",
    "page": 1,
    "limit": 50,
    "domainSearchName": "string",
    "contactHash": "string"
  }
});

assertStatus(response, 200);
  

PHP SDK

use \Mittwald\ApiClient\Generated\V2\Clients\Domain\ListDomains\ListDomainsRequest;
  
$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));

$request = (new ListDomainsRequest())
  ->withProjectId("f0f86186-0a5a-45b2-aa33-502777496347")
  ->withPage(1)
  ->withLimit(50)
  ->withDomainSearchName("string")
  ->withContactHash("string");
$response = $client->domain()->listDomains($request);

var_dump($response->getBody();