Skip to main content
GET
/
api
/
v1
/
calls
/
{call_id}
/
webhook-logs
[
  {
    "webhook_url": "<string>",
    "webhook_type": "<string>",
    "id": 123,
    "call_id": 123,
    "assistant_id": 123,
    "request_payload": {},
    "response_status_code": 123,
    "response_body": "<string>",
    "response_time_ms": 123,
    "attempted_at": "2023-11-07T05:31:56Z",
    "success": false,
    "error_message": "<string>",
    "retry_count": 0,
    "webhook_metadata": {}
  }
]
Retrieve all webhook delivery logs for a specific call. This endpoint provides detailed information about webhook requests sent during the call, including request payloads, response status codes, timing, and any errors.
Debugging Webhooks: Use this endpoint to troubleshoot webhook delivery issues, verify that events are being sent correctly, and understand the timing of webhook deliveries during a call.

​
Path Parameters

ParameterTypeRequiredDescription
call_idintegerYesThe internal call ID (not the call SID)

​
Query Parameters

ParameterTypeRequiredDescription
webhook_typestringNoFilter by webhook type (e.g., call_started, call_ended, transcript)

​
Request

curl "https://api.burki.dev/api/v1/calls/101/webhook-logs" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Filter by Webhook Type

curl "https://api.burki.dev/api/v1/calls/101/webhook-logs?webhook_type=call_ended" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

Returns an array of webhook log objects ordered by attempt time. 
[
  {
    "id": 1,
    "call_id": 101,
    "assistant_id": 123,
    "webhook_url": "https://yourapi.com/webhooks/burki",
    "webhook_type": "call_started",
    "request_payload": {
      "event": "call_started",
      "call_sid": "CAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "customer_phone_number": "+15559876543",
      "assistant_id": 123,
      "timestamp": "2024-01-15T10:00:00Z"
    },
    "response_status_code": 200,
    "response_body": "{\"received\": true}",
    "response_time_ms": 145,
    "attempted_at": "2024-01-15T10:00:00Z",
    "success": true,
    "error_message": null,
    "retry_count": 0,
    "webhook_metadata": null
  },
  {
    "id": 2,
    "call_id": 101,
    "assistant_id": 123,
    "webhook_url": "https://yourapi.com/webhooks/burki",
    "webhook_type": "call_ended",
    "request_payload": {
      "event": "call_ended",
      "call_sid": "CAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "duration": 180,
      "status": "completed",
      "transcript_summary": "Customer inquired about order status...",
      "timestamp": "2024-01-15T10:03:00Z"
    },
    "response_status_code": 200,
    "response_body": "{\"received\": true}",
    "response_time_ms": 89,
    "attempted_at": "2024-01-15T10:03:01Z",
    "success": true,
    "error_message": null,
    "retry_count": 0,
    "webhook_metadata": null
  }
]

​
Response Fields

FieldTypeDescription
idintegerUnique webhook log ID
call_idintegerID of the parent call
assistant_idintegerID of the assistant that triggered the webhook
webhook_urlstringThe URL where the webhook was sent
webhook_typestringType of webhook event
request_payloadobjectThe JSON payload sent to the webhook URL
response_status_codeintegerHTTP status code returned by your server
response_bodystringResponse body from your server (truncated if large)
response_time_msintegerTime taken for your server to respond (milliseconds)
attempted_atstringWhen the webhook was attempted (ISO 8601)
successbooleanWhether the delivery was successful
error_messagestringError message if delivery failed
retry_countintegerNumber of retry attempts made
webhook_metadataobjectAdditional metadata about the webhook

​
Webhook Types

TypeDescription
call_startedSent when a call begins
call_endedSent when a call completes
transcriptSent for real-time transcript updates
tool_callSent when a tool/function is invoked
transfer_initiatedSent when a call transfer begins
sms_receivedSent when an SMS is received

​
Error Responses

​
404 Not Found

{
  "detail": "Call with ID 101 not found in your organization"
}

​
Use Cases

​
Debug Failed Webhooks

import requests

def find_failed_webhooks(call_id):
    response = requests.get(
        f"https://api.burki.dev/api/v1/calls/{call_id}/webhook-logs",
        headers={"Authorization": "Bearer YOUR_API_KEY"}
    )
    
    logs = response.json()
    
    failed = [log for log in logs if not log["success"]]
    
    for log in failed:
        print(f"Failed webhook: {log['webhook_type']}")
        print(f"  URL: {log['webhook_url']}")
        print(f"  Error: {log['error_message']}")
        print(f"  Status Code: {log['response_status_code']}")
        print(f"  Retries: {log['retry_count']}")
        print()
    
    return failed

​
Monitor Webhook Latency

def analyze_webhook_performance(call_id):
    response = requests.get(
        f"https://api.burki.dev/api/v1/calls/{call_id}/webhook-logs",
        headers={"Authorization": "Bearer YOUR_API_KEY"}
    )
    
    logs = response.json()
    
    successful_logs = [log for log in logs if log["success"]]
    
    if not successful_logs:
        return None
    
    response_times = [log["response_time_ms"] for log in successful_logs]
    
    return {
        "avg_response_time_ms": sum(response_times) / len(response_times),
        "max_response_time_ms": max(response_times),
        "min_response_time_ms": min(response_times),
        "total_webhooks": len(successful_logs)
    }

​
Verify Webhook Delivery

def verify_webhook_delivery(call_id, expected_types):
    """Verify that all expected webhook types were delivered successfully."""
    response = requests.get(
        f"https://api.burki.dev/api/v1/calls/{call_id}/webhook-logs",
        headers={"Authorization": "Bearer YOUR_API_KEY"}
    )
    
    logs = response.json()
    
    delivered_types = set(
        log["webhook_type"] for log in logs if log["success"]
    )
    
    missing = set(expected_types) - delivered_types
    
    return {
        "all_delivered": len(missing) == 0,
        "delivered": list(delivered_types),
        "missing": list(missing)
    }

# Example usage
result = verify_webhook_delivery(101, ["call_started", "call_ended"])
print(f"All webhooks delivered: {result['all_delivered']}")

​
Notes

  • Webhooks are only sent if you have configured a webhook_url on your assistant
  • Failed webhooks are automatically retried up to 3 times with exponential backoff
  • Response bodies larger than 10KB are truncated in the logs
  • Webhook logs are retained for 30 days

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
call_id
integer
required

Query Parameters

​
webhook_type
string | null

Filter by webhook type

Response

Successful Response

​
webhook_url
string
required
​
webhook_type
string
required
​
id
integer
required
​
call_id
integer
required
​
assistant_id
integer
required
​
request_payload
Request Payload · object
​
response_status_code
integer | null
​
response_body
string | null
​
response_time_ms
integer | null
​
attempted_at
string<date-time> | null
​
success
boolean
default:false
​
error_message
string | null
​
retry_count
integer
default:0
​
webhook_metadata
Webhook Metadata · object