# 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)

Endpoint: GET /api/audit-logs
Security: ApiKeyAuth

## Query parameters:

  - `subscriptionId` (string)
    Filter by subscription ID
    Example: "507f1f77bcf86cd799439011"

  - `status` (string)
    Filter by delivery status
    Enum: "success", "failed", "permanent_failure"

  - `limit` (integer)
    Maximum number of results (1-100)
    Example: 50

  - `offset` (integer)
    Number of results to skip

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.id` (string, required)
    Example: "log-123"

  - `data.subscriptionId` (string, required)
    Example: "sub-123"

  - `data.payloadId` (string, required)
    Example: "payload-456"

  - `data.status` (string, required)
    Enum: "success", "failed", "permanent_failure"

  - `data.statusCode` (integer)
    Example: 200

  - `data.url` (string, required)
    Example: "https://example.com/webhook"

  - `data.deliveredAt` (string, required)
    Example: "2024-01-01T00:00:00.000Z"

  - `data.durationMs` (integer)
    Example: 150

  - `data.error` (string,null)

  - `pagination` (object, required)

  - `pagination.total` (integer, required)
    Example: 100

  - `pagination.limit` (integer, required)
    Example: 50

  - `pagination.offset` (integer, required)

  - `pagination.hasMore` (boolean, required)
    Example: true

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]