lomi.
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

ParameterTypeRequiredDescription
webhookIdstringYesFilter by webhook ID
successOnlybooleanNoShow only successful deliveries
failedOnlybooleanNoShow only failed deliveries
limitnumberNoResults per page (default: 25)
offsetnumberNoPagination 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

FieldTypeDescription
idstringUnique log identifier
webhook_idstringAssociated webhook ID
event_typestringEvent that triggered delivery
request_urlstringWebhook endpoint URL
request_headersobjectHeaders sent with request
request_bodyobjectPayload sent
response_status_codenumberHTTP status received
response_bodystringResponse body received
duration_msnumberRequest duration in ms
successbooleanWhether delivery succeeded
error_messagestringError message (if failed)
attempt_numbernumberRetry attempt number
created_atstringDelivery timestamp

Error Responses

StatusDescription
401Invalid or missing API key
404Log not found or access denied

On this page