Platform
Webhook Delivery Logs
Monitor and debug webhook delivery attempts.
The Webhook Delivery Logs API provides read-only access to webhook delivery history. Logs are automatically created when webhooks are delivered to your endpoints.
List delivery logs
Retrieve delivery logs for a specific webhook.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookId | string | Yes | Filter by webhook ID |
successOnly | boolean | No | Show only successful deliveries |
failedOnly | boolean | No | Show only failed deliveries |
limit | number | No | Results per page (default: 25) |
offset | number | No | Pagination offset (default: 0) |
import { LomiSDK } from '@lomi./sdk';
const lomi = new LomiSDK({
apiKey: process.env.LOMI_API_KEY!,
environment: 'live',
});
// List all logs for a webhook
const logs = await lomi.webhookDeliveryLogs.list({
webhookId: 'wh_abc123...',
});
// Filter for failures only
const failedLogs = await lomi.webhookDeliveryLogs.list({
webhookId: 'wh_abc123...',
failedOnly: true,
limit: 50,
});
console.log(`Found ${failedLogs.length} failed deliveries`);from lomi import LomiClient
import os
client = LomiClient(
api_key=os.environ["LOMI_API_KEY"],
environment="test"
)
# List all logs for a webhook
logs = client.webhook_delivery_logs.list(webhookId="wh_abc123...")
# List failed deliveries
failed_logs = client.webhook_delivery_logs.list(
webhookId="wh_abc123...",
failedOnly=True
)
print(f"Found {len(failed_logs)} failed deliveries")# List all logs for a webhook
curl -X GET "https://api.lomi.africa/webhook-delivery-logs?webhookId=wh_abc123..." \
-H "X-API-KEY: $LOMI_API_KEY"
# List failed deliveries only
curl -X GET "https://api.lomi.africa/webhook-delivery-logs?webhookId=wh_abc123...&failedOnly=true" \
-H "X-API-KEY: $LOMI_API_KEY"Get a delivery log
Retrieve details of a specific delivery attempt, including request/response data and timing.
const log = await lomi.webhookDeliveryLogs.get('log_abc123...');
console.log(`Event: ${log.event_type}`);
console.log(`Status: ${log.response_status_code}`);
console.log(`Duration: ${log.duration_ms}ms`);
console.log(`Success: ${log.success}`);log = client.webhook_delivery_logs.get('log_abc123...')
print(f"Event: {log['event_type']}")
print(f"Status: {log['response_status_code']}")
print(f"Duration: {log['duration_ms']}ms")curl -X GET "https://api.lomi.africa/webhook-delivery-logs/log_abc123..." \
-H "X-API-KEY: $LOMI_API_KEY"Webhook Delivery Log Object
| Field | Type | Description |
|---|---|---|
id | string | Unique log identifier |
webhook_id | string | Associated webhook ID |
event_type | string | Event that triggered delivery |
request_url | string | Webhook endpoint URL |
request_headers | object | Headers sent with request |
request_body | object | Payload sent |
response_status_code | number | HTTP status received |
response_body | string | Response body received |
duration_ms | number | Request duration in ms |
success | boolean | Whether delivery succeeded |
error_message | string | Error message (if failed) |
attempt_number | number | Retry attempt number |
created_at | string | Delivery timestamp |
Error Responses
| Status | Description |
|---|---|
401 | Invalid or missing API key |
404 | Log not found or access denied |