Webhooks

One webhook event, with its data

GET /v1/webhook-events/{event_id}

Scope

webhooks:read

Tier

Tier 1

Data

Personal data

Idempotency

Idempotency-Key: not used

Parameters

Response

200: The event.

Examples

Request example

curl

curl -sS -X GET \
  "https://app.dialerbee.com/api/v1/webhook-events/evt_0f8fad5b-d9cb-469f-a165-70867728950e" \
  -H "Authorization: Bearer $DIALERBEE_API_KEY"

Python (SDK)

from dialerbee import DialerBee

db = DialerBee()  # reads DIALERBEE_API_KEY from the environment

result = db.webhook_events.get("evt_0f8fad5b-d9cb-469f-a165-70867728950e")

Response example

200

{
  "id": "evt_0f8fad5b-d9cb-469f-a165-70867728950e",
  "type": "call.completed",
  "created_at": "2026-09-29T09:15:00Z",
  "api_version": "v1",
  "schema_version": 1,
  "deliveries": [
    {
      "id": "whd_0f8fad5b-d9cb-469f-a165-70867728950e",
      "webhook_id": "wh_0f8fad5b-d9cb-469f-a165-70867728950e",
      "status": "delivered",
      "attempts": 1,
      "replay_of": null,
      "last_status_code": 200,
      "last_attempt_at": "2026-09-29T11:58:00Z",
      "next_attempt_at": "2026-09-30T10:00:00Z",
      "delivered_at": "2026-09-29T12:00:02Z",
      "failure_reason": null,
      "created_at": "2026-09-29T09:15:00Z"
    }
  ],
  "data": {
    "call_id": "call_0f8fad5b-d9cb-469f-a165-70867728950e",
    "direction": "outbound",
    "status": "completed",
    "from": "+12125550100",
    "to": "+12125550123",
    "campaign_id": "cmp_0f8fad5b-d9cb-469f-a165-70867728950e",
    "started_at": "2026-09-29T11:58:00Z",
    "answered_at": "2026-09-29T11:58:07Z",
    "ended_at": "2026-09-29T11:59:40Z",
    "duration_seconds": 93,
    "hangup_cause": "NORMAL_CLEARING"
  }
}

Error examples

403 insufficient_scope

{
  "type": "https://docs.dialerbee.com/errors/insufficient-scope",
  "title": "Not permitted",
  "status": 403,
  "detail": "The API client does not hold the scope this operation requires.",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "insufficient_scope",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

401 invalid_api_key

{
  "type": "https://docs.dialerbee.com/errors/invalid-api-key",
  "title": "Invalid API key",
  "status": 401,
  "detail": "The Authorization header is missing, is not Bearer dbk_live_..., or the key is not recognised, has expired or was revoked (one answer for every key problem, so a key's state is never revealed).",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "invalid_api_key",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

Errors

Objects

WebhookEventDetail

WebhookDelivery