# Zonemaster

> Check the health of a domain's DNS with Zonemaster, the free test from AFNIC and Internetstiftelsen: name servers, delegation, IPv4 and IPv6 reachability and DNSSEC, with a verdict and the problems found. Also reads a domain's test history and its delegation in the parent zone. No account or API key required.

App · 7 actions. Web page: https://docs.lodol.com/docs/integrations/zonemaster

## Actions

### Get delegation from parent zone

See which name servers the parent zone (.com for example.com) sends people to for a domain, with their addresses, and its DS records, which show whether DNSSEC is switched on at the registry.

**Inputs**

- Domain (`domain`, text, required): The domain to test, such as example.com. A web address or an email address works too: only the domain is used.

**Outputs**

- `dnssec` (true/false): True when the parent zone holds DS records for the domain.
- `domain` (text): The domain looked up.
- `ds_records` (list): The DS records. Empty without DNSSEC.
- `found` (true/false): True when the parent zone lists name servers for the domain. False usually means the domain is not registered.
- `name_server_names` (list): The name servers' host names, each once.
- `name_servers` (list): Each name server address, one entry per address.

**Example output**

```json
{
  "dnssec": true,
  "domain": "zonemaster.net",
  "ds_records": [
    {
      "algorithm": 13,
      "digest": "f1129cebe8060b98e352d8c1e5f783130705caf1590c2275af05fa9062ccd5f7",
      "digest_type": 2,
      "key_tag": 14966
    }
  ],
  "found": true,
  "name_server_names": [
    "ns2.nic.fr",
    "nsa.dnsnode.net",
    "nsp.dnsnode.net",
    "nsu.dnsnode.net"
  ],
  "name_servers": [
    {
      "ip": "192.93.0.4",
      "name": "ns2.nic.fr"
    },
    {
      "ip": "2001:660:3005:1::1:2",
      "name": "ns2.nic.fr"
    },
    {
      "ip": "194.58.192.46",
      "name": "nsa.dnsnode.net"
    },
    {
      "ip": "2a01:3f1:46::53",
      "name": "nsa.dnsnode.net"
    },
    {
      "ip": "194.58.198.32",
      "name": "nsp.dnsnode.net"
    },
    {
      "ip": "2a01:3f1:3032::53",
      "name": "nsp.dnsnode.net"
    },
    {
      "ip": "185.42.137.98",
      "name": "nsu.dnsnode.net"
    },
    {
      "ip": "2a01:3f0:400::32",
      "name": "nsu.dnsnode.net"
    }
  ]
}
```

### Get test history

List earlier Zonemaster tests of a domain, newest first, with each one's verdict and report link. Anyone's tests of the domain on zonemaster.net are included.

**Inputs**

- Domain (`domain`, text, required): The domain to test, such as example.com. A web address or an email address works too: only the domain is used.
- Which tests (`which_tests`, text): All tests, or only those of the live name servers or of chosen ones. Defaults to all. One of: `all` (All tests), `delegated` (Only tests of the live name servers), `undelegated` (Only tests of chosen name servers). Default: `all`.
- How many (`limit`, number): How many tests to list, 1 to 200. Defaults to 20. From 1 to 200. Default: `20`.
- Skip (`offset`, number): How many of the newest tests to skip, to see older ones. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many tests are listed.
- `domain` (text): The domain whose tests these are.
- `tests` (list): The tests, newest first.

**Example output**

```json
{
  "count": 2,
  "domain": "lodol.com",
  "tests": [
    {
      "created_at": "2026-10-19T22:41:10Z",
      "overall_result": "warning",
      "report_url": "https://zonemaster.net/en/result/e78e9a8110f016ef",
      "test_id": "e78e9a8110f016ef",
      "undelegated": false
    },
    {
      "created_at": "2026-10-19T22:37:06Z",
      "overall_result": "warning",
      "report_url": "https://zonemaster.net/en/result/25613acd89c2cfe7",
      "test_id": "25613acd89c2cfe7",
      "undelegated": false
    }
  ]
}
```

### Get test progress

See how far a Zonemaster test has got, from 0 to 100 percent, without waiting for it.

**Inputs**

- Test ID (`test_id`, text, required): The test's id, from 'Start a domain test' or 'Get test history': 16 letters and digits. A zonemaster.net report link works too.

**Outputs**

- `finished` (true/false): True once the test is done.
- `progress` (number): How far the test has got, from 0 to 100 percent.
- `report_url` (text): The test's full report on zonemaster.net, to open or share.
- `test_id` (text): Zonemaster's id for the test: 16 letters and digits.

**Example output**

```json
{
  "finished": true,
  "progress": 100,
  "report_url": "https://zonemaster.net/en/result/25613acd89c2cfe7",
  "test_id": "25613acd89c2cfe7"
}
```

### Get test results

Get a Zonemaster test's verdict (ok, warning, error or critical), its findings and the report link. Waits up to 4 minutes for a test still running, unless told not to.

**Inputs**

- Test ID (`test_id`, text, required): The test's id, from 'Start a domain test' or 'Get test history': 16 letters and digits. A zonemaster.net report link works too.
- Language (`language`, text): The language of the findings. Defaults to English. Default: `en`.
- Show (`show`, text): Which findings to list. A healthy domain has dozens of information messages, so the default lists problems only. The counts always include everything. One of: `problems` (Problems only (warnings, errors and critical)), `errors` (Errors and critical only), `notices` (Notices and problems), `all` (Everything, including information). Default: `problems`.
- Wait for the test to finish (`wait`, true/false): Wait up to 4 minutes for a test still running. Turn off to get its progress at once. Default: `true`.

**Outputs**

- `counts` (object): How many messages the test produced at each level, whatever 'Show' was set to.
- `created_at` (text): When the test was started, in UTC (ISO 8601).
- `domain` (text): The domain that was tested.
- `finished` (true/false): True once the test is done. False when it was still running when the step stopped waiting; get the results again with the test id.
- `messages` (list): The findings chosen in 'Show', worst first.
- `overall_result` (text): The verdict: 'ok' (only information and notices), 'warning', 'error' or 'critical', from the worst message. Empty while the test runs.
- `progress` (number): How far the test got, from 0 to 100 percent.
- `report_url` (text): The test's full report on zonemaster.net, to open or share.
- `settings` (object): The settings the test ran with.
- `summary` (text): One line with the verdict and the number of problems.
- `test_id` (text): Zonemaster's id for the test: 16 letters and digits.

**Example output**

```json
{
  "counts": {
    "critical": 0,
    "error": 0,
    "info": 69,
    "notice": 0,
    "warning": 4
  },
  "created_at": "2026-10-19T22:37:06Z",
  "domain": "lodol.com",
  "finished": true,
  "messages": [
    {
      "area": "Connectivity",
      "level": "warning",
      "message": "All authoritative nameservers have their IPv4 addresses in the same AS (44273).",
      "name_server": null,
      "test_case": "Connectivity03",
      "test_case_name": "AS Diversity"
    },
    {
      "area": "Connectivity",
      "level": "warning",
      "message": "All authoritative nameservers have their IPv6 addresses in the same AS (44273).",
      "name_server": null,
      "test_case": "Connectivity03",
      "test_case_name": "AS Diversity"
    },
    {
      "area": "DNSSEC",
      "level": "warning",
      "message": "The following name servers respond with no DNSKEY (unsigned child zone). Name servers: \"ns67.domaincontrol.com/97.74.103.44; ns67.domaincontrol.com/2603:5:2174::2c; ns68.domaincontrol.com/173.201.71.44; ns68.domaincontrol.com/2603:5:2274::2c\".",
      "name_server": null,
      "test_case": "DNSSEC07",
      "test_case_name": "DNSSEC signed zone and DS in parent for signed zone"
    },
    {
      "area": "DNSSEC",
      "level": "warning",
      "message": "The zone is not signed.",
      "name_server": null,
      "test_case": "DNSSEC07",
      "test_case_name": "DNSSEC signed zone and DS in parent for signed zone"
    }
  ],
  "overall_result": "warning",
  "progress": 100,
  "report_url": "https://zonemaster.net/en/result/25613acd89c2cfe7",
  "settings": {
    "ipv4": true,
    "ipv6": true,
    "name_servers": [],
    "profile": "default",
    "undelegated": false
  },
  "summary": "lodol.com: warnings found (4 warnings)",
  "test_id": "25613acd89c2cfe7"
}
```

### Look up host addresses

Get the IPv4 and IPv6 addresses of a host name, such as a name server, as Zonemaster sees them. Useful for listing name servers to test with their addresses.

**Inputs**

- Host name (`hostname`, text, required): The host to look up, such as ns1.example.com.

**Outputs**

- `addresses` (list): Every address, IPv4 first.
- `found` (true/false): True when it has at least one address.
- `hostname` (text): The host name looked up.
- `ipv4` (list): Its IPv4 addresses.
- `ipv6` (list): Its IPv6 addresses.

**Example output**

```json
{
  "addresses": [
    "192.93.0.4",
    "2001:660:3005:1::1:2"
  ],
  "found": true,
  "hostname": "ns2.nic.fr",
  "ipv4": [
    "192.93.0.4"
  ],
  "ipv6": [
    "2001:660:3005:1::1:2"
  ]
}
```

### Start a domain test

Start a Zonemaster DNS health test of a domain without waiting for it. Returns the test id and report link; use 'Get test results' for the verdict. A test of the same domain with the same settings in the last 10 minutes is reused.

**Inputs**

- Domain (`domain`, text, required): The domain to test, such as example.com. A web address or an email address works too: only the domain is used.
- Test profile (`profile`, text): The set of checks to run. Leave it on Default unless told otherwise. Default: `default`.
- Test over IPv4 (`ipv4`, true/false): Check the name servers over IPv4. Default: `true`.
- Test over IPv6 (`ipv6`, true/false): Check the name servers over IPv6. Default: `true`.
- Name servers to test instead (`name_servers`, list): To test name servers before the domain points at them (such as when moving DNS host), list them here, one per entry: a host name, optionally followed by its IP address, like ns1.example.com 192.0.2.1. Leave empty to test the domain as it is live.

**Outputs**

- `domain` (text): The domain being tested.
- `report_url` (text): The test's full report on zonemaster.net, to open or share.
- `settings` (object): The settings the test ran with.
- `test_id` (text): Zonemaster's id for the test: 16 letters and digits.

**Example output**

```json
{
  "domain": "lodol.com",
  "report_url": "https://zonemaster.net/en/result/25613acd89c2cfe7",
  "settings": {
    "ipv4": true,
    "ipv6": true,
    "name_servers": [],
    "profile": "default",
    "undelegated": false
  },
  "test_id": "25613acd89c2cfe7"
}
```

### Test a domain

Check a domain's DNS health with Zonemaster and wait for the verdict: whether its name servers answer and agree, can be reached over IPv4 and IPv6, and whether DNSSEC is set up right. Returns ok, warning, error or critical, the problems found and a link to the full report. A test usually takes under a minute; if it takes over 4 minutes the step returns the test id so 'Get test results' can pick it up.

**Inputs**

- Domain (`domain`, text, required): The domain to test, such as example.com. A web address or an email address works too: only the domain is used.
- Test profile (`profile`, text): The set of checks to run. Leave it on Default unless told otherwise. Default: `default`.
- Test over IPv4 (`ipv4`, true/false): Check the name servers over IPv4. Default: `true`.
- Test over IPv6 (`ipv6`, true/false): Check the name servers over IPv6. Default: `true`.
- Name servers to test instead (`name_servers`, list): To test name servers before the domain points at them (such as when moving DNS host), list them here, one per entry: a host name, optionally followed by its IP address, like ns1.example.com 192.0.2.1. Leave empty to test the domain as it is live.
- Language (`language`, text): The language of the findings. Defaults to English. Default: `en`.
- Show (`show`, text): Which findings to list. A healthy domain has dozens of information messages, so the default lists problems only. The counts always include everything. One of: `problems` (Problems only (warnings, errors and critical)), `errors` (Errors and critical only), `notices` (Notices and problems), `all` (Everything, including information). Default: `problems`.

**Outputs**

- `counts` (object): How many messages the test produced at each level, whatever 'Show' was set to.
- `created_at` (text): When the test was started, in UTC (ISO 8601).
- `domain` (text): The domain that was tested.
- `finished` (true/false): True once the test is done. False when it was still running when the step stopped waiting; get the results again with the test id.
- `messages` (list): The findings chosen in 'Show', worst first.
- `overall_result` (text): The verdict: 'ok' (only information and notices), 'warning', 'error' or 'critical', from the worst message. Empty while the test runs.
- `progress` (number): How far the test got, from 0 to 100 percent.
- `report_url` (text): The test's full report on zonemaster.net, to open or share.
- `settings` (object): The settings the test ran with.
- `summary` (text): One line with the verdict and the number of problems.
- `test_id` (text): Zonemaster's id for the test: 16 letters and digits.

**Example output**

```json
{
  "counts": {
    "critical": 0,
    "error": 0,
    "info": 69,
    "notice": 0,
    "warning": 4
  },
  "created_at": "2026-10-19T22:37:06Z",
  "domain": "lodol.com",
  "finished": true,
  "messages": [
    {
      "area": "Connectivity",
      "level": "warning",
      "message": "All authoritative nameservers have their IPv4 addresses in the same AS (44273).",
      "name_server": null,
      "test_case": "Connectivity03",
      "test_case_name": "AS Diversity"
    },
    {
      "area": "Connectivity",
      "level": "warning",
      "message": "All authoritative nameservers have their IPv6 addresses in the same AS (44273).",
      "name_server": null,
      "test_case": "Connectivity03",
      "test_case_name": "AS Diversity"
    },
    {
      "area": "DNSSEC",
      "level": "warning",
      "message": "The following name servers respond with no DNSKEY (unsigned child zone). Name servers: \"ns67.domaincontrol.com/97.74.103.44; ns67.domaincontrol.com/2603:5:2174::2c; ns68.domaincontrol.com/173.201.71.44; ns68.domaincontrol.com/2603:5:2274::2c\".",
      "name_server": null,
      "test_case": "DNSSEC07",
      "test_case_name": "DNSSEC signed zone and DS in parent for signed zone"
    },
    {
      "area": "DNSSEC",
      "level": "warning",
      "message": "The zone is not signed.",
      "name_server": null,
      "test_case": "DNSSEC07",
      "test_case_name": "DNSSEC signed zone and DS in parent for signed zone"
    }
  ],
  "overall_result": "warning",
  "progress": 100,
  "report_url": "https://zonemaster.net/en/result/25613acd89c2cfe7",
  "settings": {
    "ipv4": true,
    "ipv6": true,
    "name_servers": [],
    "profile": "default",
    "undelegated": false
  },
  "summary": "lodol.com: warnings found (4 warnings)",
  "test_id": "25613acd89c2cfe7"
}
```
