A DNS record group is a logical collection of DNS records. DNS record groups can have a one-to-one correlation with zone files, but other types of groupings are possible as well, such as grouping by service or customer. See the DNS record groups page for more details.
The DNS Check API is used to request data for either a specific record group or all DNS record groups owned by your account.
URL
https://www.dnscheck.co/api/v1/groups/:group_uuid?api_key=KEY
Parameters
All of the parameters described below are required.
| Parameter | Description | Example Value |
|---|---|---|
| api_key | The secret key used to authenticate the connecting application. Refer to the Generating an API Key page for details. | abcdefghbcdefghbcdefghbcdefgh |
| group_uuid | The UUID of the DNS record group. When viewing a DNS record or record group, this is the 36-character string that follows "/tests/" in the URL. The UUID of this DNS record group is "ea883d67-d9f6-45e3-b3a1-844dd1857824". Specify a group_uuid of "all" to show information for all of your account's DNS record groups. | ea883d67-d9f6-45e3-b3a1-844dd1857824 |
Example Request
The following API call returns data for this example DNS record group:
GET https://www.dnscheck.co/api/v1/groups/ea883d67-d9f6-45e3-b3a1-844dd1857824?api_key=KEY
The above DNS record group is unique in that accessing it does not require a valid API key. It serves as a live example for API documentation.
Example Response
{
"group": {
"uuid": "ea883d67-d9f6-45e3-b3a1-844dd1857824",
"name": "Example DNS Check",
"description": "This example set of DNS records shows how DNS Check presents the results of its checks. Records which pass appear in green, and those that fail appear in red.",
"nameservers": "",
"public": true,
"created_at": "2015-04-10T20:38:46+00:00",
"updated_at": "2024-10-28T20:05:12+00:00",
"notifications": true,
"status": "fail",
"url": "https://www.dnscheck.co/tests/ea883d67-d9f6-45e3-b3a1-844dd1857824"
}
}
Response Definitions
| Parameter | Description | Type |
|---|---|---|
| uuid | A Universally Unique Identifier for the DNS record group | string |
| name | The name of the DNS record group | string |
| description | The description of the DNS record group | string |
| nameservers | A comma delimited list of nameservers. For example, "8.8.8.8, 8.4.4.4". If blank, DNS Check's default nameservers are queried. Each name server can be a fully qualified domain name, an IPv4 address, or an IPv6 address | string |
| public | Indicates whether this DNS record group is publicly viewable | boolean |
| created_at | The ISO 8601 time and date the DNS record group was created | string |
| updated_at | The ISO 8601 time and date the DNS record group was last updated | string |
| notifications | Whether notifications are enabled for this DNS record group | boolean |
| status | The pass/fail status of the DNS record group. Valid values are "pass", "fail", and "unknown" | string |
| url | The URL of the DNS record group's page | string |