Webhook Delivery Logs

The Webhook Delivery Logs API provides read-only access to webhook delivery history. Logs are automatically created when webhooks are delivered to your endpoints.

Use Webhook reliability to interpret retries, failures, and idempotent handling.

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