Skip to main content
GET
/
webhooks
List webhooks
curl --request GET \
  --url https://api.dnsradar.dev/webhooks \
  --header 'X-Api-Key: <api-key>'
{
  "limit": 20,
  "after": "<string>",
  "before": "<string>",
  "has_more": true,
  "data": [
    {
      "id": "whk_abc123...",
      "created": "2023-11-07T05:31:56Z",
      "url": "https://api.server.com/webhook/dnsradar",
      "method": "POST",
      "headers": {
        "Authorization": "Bearer abc123token",
        "X-Custom-Header": "value"
      },
      "secret": "Ultra Secure P@ssw0rd!",
      "is_active": true,
      "last_error": "Timeout connecting to endpoint",
      "last_executed": "2023-11-07T05:31:56Z",
      "groups": [
        "grp_abc123...",
        "grp_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.

You can filter webhooks by their active status using the is_active query parameter.
For example: ?is_active=true

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
​
is_active
boolean

Filter by active status

Response

Paginated list of webhooks

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