Skip to main content
GET
/
groups
List groups
curl --request GET \
  --url https://api.dnsradar.dev/groups \
  --header 'X-Api-Key: <api-key>'
{
  "limit": 20,
  "after": "<string>",
  "before": "<string>",
  "has_more": true,
  "data": [
    {
      "id": "grp_abc123...",
      "slug": "production-servers",
      "name": "Production Servers",
      "is_default": true,
      "monitors": 42,
      "webhooks": [
        "whk_abc123...",
        "whk_def456..."
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.dnsradar.dev/llms.txt

Use this file to discover all available pages before exploring further.

Groups help you organize your monitors into logical collections for easier management and reporting.
You can filter monitors by group using the group query parameter on the /monitors endpoint.
A default group is automatically created and cannot be removed, but can be renamed. This is required in order to attach a monitor to a group that will be used to send Webhook notifications.

Authorizations

​
X-Api-Key
string
header
required

API key used to authenticate yourself on DNSRadar. Obtain your API key from your DNSRadar dashboard.

Query Parameters

​
after
string

Cursor for fetching the next page of results. Use the value from the previous response's 'after' field.

​
before
string

Cursor for fetching the previous page of results. Use the value from the previous response's 'before' field.

​
limit
integer
default:20

Number of items per page (1-100, default: 20)

Required range: 1 <= x <= 100
​
order_by
string

Field to order results by

​
order_way
enum<string>
default:asc

Sort direction

Available options:
asc,
desc

Response

Paginated list of groups

Paginated response wrapper for list endpoints. Uses cursor-based pagination with after/before parameters.

​
limit
integer

Number of items per page (max 100)

Example:

20

​
after
string | null

Cursor to fetch the next page of results

​
before
string | null

Cursor to fetch the previous page of results

​
has_more
boolean

Indicates if there are more items to fetch

​
data
object[]

Array of items for the current page