Webhooks
Get Audit Logs
Retrieve webhook delivery logs for your account.
Endpoint: (GET) https://api.lusha.com/api/audit-logs
What's Logged:
- All webhook delivery attempts (success and failures)
- HTTP status codes and response times
- Error messages for failed deliveries
- Delivery timestamps and duration metrics
Filtering:
- Filter by subscription ID to see logs for specific subscriptions
- Filter by status to see only successes, failures, or permanent failures
Rate Limit: 100 requests/minute per account
Note: Logs are retained for 90 days (successful) and 180 days (failed/DLQ)
get/api/audit-logs
Query parameters
subscriptionIdstring
Filter by subscription ID
status'success' | 'failed' | 'permanent_failure'
Filter by delivery status
limitinteger
Maximum number of results (1-100)
offsetinteger
Number of results to skip
Response
Audit logs retrieved successfully
Example response
{
"data": [
{
"id": "log-123",
"subscriptionId": "sub-123",
"payloadId": "payload-456",
"status": "success",
"statusCode": 200,
"url": "https://example.com/webhook",
"deliveredAt": "2024-01-01T00:00:00.000Z",
"durationMs": 150
}
],
"pagination": {
"total": 100,
"limit": 50,
"hasMore": true
}
}