View Webhook Request History

The webhook requests API provides visibility into every delivery attempt, helping you debug issues, monitor performance, and verify webhook behavior.

List Webhook Requests

Get request history for a webhook:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "limit": 20,
  "after": "req_xyz789",
  "before": null,
  "has_more": true,
  "data": [
    {
      "uuid": "req_def456",
      "webhook_uuid": "wh_abc123",
      "event_uuid": "evt_ghi789",
      "created": "2026-01-08T14:25:30Z",
      "status_code": 200,
      "response_body": "OK",
      "error_message": null
    },
    {
      "uuid": "req_jkl012",
      "webhook_uuid": "wh_abc123",
      "event_uuid": "evt_mno345",
      "created": "2026-01-08T13:10:15Z",
      "status_code": 500,
      "response_body": "Internal Server Error",
      "error_message": "Connection timeout"
    }
  ]
}

Pagination

Webhook requests use cursor-based pagination:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?after=req_xyz789&limit=50 \
  -H "X-API-Key: YOUR_API_KEY"

Query Parameters

ParameterTypeDescription
limitintegerResults per page (1-100, default: 20)
afterstringCursor for next page
beforestringCursor for previous page
order_bystringSort field (e.g., created)
order_waystringSort direction (asc or desc)
created_afterintegerUTC timestamp - requests created after this time
created_beforeintegerUTC timestamp - requests created before this time
delivered_afterintegerUTC timestamp - requests delivered after this time
delivered_beforeintegerUTC timestamp - requests delivered before this time
last_attempt_afterintegerUTC timestamp - last delivery attempt after this time
last_attempt_beforeintegerUTC timestamp - last delivery attempt before this time
status_codeintegerFilter by HTTP status code (e.g., 200, 500)

Filtering Requests

Filter by Creation Time

Get requests based on when they were created, using UTC timestamps (seconds since epoch).

Requests created after a specific time:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?created_after=1767793661 \
  -H "X-API-Key: YOUR_API_KEY"

Requests created before a specific time:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?created_before=1767880061 \
  -H "X-API-Key: YOUR_API_KEY"

Requests created within a time range:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?created_after=1767793661&created_before=1767880061 \
  -H "X-API-Key: YOUR_API_KEY"

Filter by Delivery Time

Get requests based on when they were successfully delivered.

Requests delivered after a specific time:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?delivered_after=1767793661 \
  -H "X-API-Key: YOUR_API_KEY"

Requests delivered before a specific time:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?delivered_before=1767880061 \
  -H "X-API-Key: YOUR_API_KEY"

Requests delivered within a time range:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?delivered_after=1767793661&delivered_before=1767880061 \
  -H "X-API-Key: YOUR_API_KEY"

Filter by Last Attempt Time

Get requests based on when the last delivery attempt was made.

Requests with last attempt after a specific time:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?last_attempt_after=1767793661 \
  -H "X-API-Key: YOUR_API_KEY"

Requests with last attempt before a specific time:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?last_attempt_before=1767880061 \
  -H "X-API-Key: YOUR_API_KEY"

Requests with last attempt within a time range:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?last_attempt_after=1767793661&last_attempt_before=1767880061 \
  -H "X-API-Key: YOUR_API_KEY"

Filter by Status Code

Get requests by HTTP response status code.

Successful requests only (200-299):

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=200 \
  -H "X-API-Key: YOUR_API_KEY"

Server errors (500-599):

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=500 \
  -H "X-API-Key: YOUR_API_KEY"

Unauthorized requests (401):

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=401 \
  -H "X-API-Key: YOUR_API_KEY"

Not found errors (404):

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=404 \
  -H "X-API-Key: YOUR_API_KEY"

Rate limit errors (429):

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=429 \
  -H "X-API-Key: YOUR_API_KEY"

Sorting Options

Sort by creation timestamp.

Sort by creation time (descending, newest first):

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?order_by=created&order_way=desc \
  -H "X-API-Key: YOUR_API_KEY"

Sort by creation time (ascending, oldest first):

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?order_by=created&order_way=asc \
  -H "X-API-Key: YOUR_API_KEY"

Combining Filters

Combine multiple filters to create powerful queries.

Recent failures (last 24 hours):

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=500&created_after=1767793661&order_by=created&order_way=desc&limit=50 \
  -H "X-API-Key: YOUR_API_KEY"

Successful requests in a time range:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=200&created_after=1767793661&created_before=1767880061&order_by=created&order_way=asc \
  -H "X-API-Key: YOUR_API_KEY"

Latest 100 requests, sorted newest first:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?order_by=created&order_way=desc&limit=100 \
  -H "X-API-Key: YOUR_API_KEY"

Recent authorization failures:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=401&created_after=1767793661&limit=20 \
  -H "X-API-Key: YOUR_API_KEY"

Successfully delivered requests in last hour:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=200&delivered_after=1767880061&order_by=created&order_way=desc \
  -H "X-API-Key: YOUR_API_KEY"

Failed delivery attempts in specific period:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?status_code=500&last_attempt_after=1767793661&last_attempt_before=1767880061&order_by=created&order_way=desc \
  -H "X-API-Key: YOUR_API_KEY"

Recent retry attempts (last attempt in last 30 minutes):

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?last_attempt_after=1767878261&order_by=created&order_way=desc&limit=50 \
  -H "X-API-Key: YOUR_API_KEY"

Requests created but not delivered yet:

curl -X GET https://api.dnsradar.dev/webhooks/wh_abc123/requests?created_after=1767793661&delivered_before=1767793661&order_by=created&order_way=desc \
  -H "X-API-Key: YOUR_API_KEY"

Request Fields

FieldDescription
uuidUnique request identifier (req_)
webhook_uuidAssociated webhook ID
event_uuidAssociated event ID
createdISO 8601 timestamp
status_codeHTTP status code from endpoint
response_bodyResponse body (truncated to 4000 chars)
error_messageError description (if failed)

Identifying Issues

Common Error Messages

ErrorCauseSolution
Connection timeoutEndpoint slow/unresponsiveOptimize response time
DNS resolution failedInvalid hostnameVerify webhook URL
SSL certificate errorInvalid/expired certUpdate SSL certificate
Connection refusedEndpoint not listeningStart endpoint server

Next Steps