---
title: "List firm-wide audit events"
method: GET
path: "/firm/audit-log"
tags: ["Administration"]
---

# List firm-wide audit events

`GET /firm/audit-log`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/firm/audit-log`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Read-only; any firm member. view=companies (default) lists audit events across every company the caller can access, or one companyId; view=firm lists the firm workspace's own events. Same row shape and filters as /audit-log, plus the accessible companies list.

## Query parameters

- `view` string
- `companyId` string, uuid
- `actor` string
- `entityType` string
- `action` string
- `startDate` string
- `endDate` string
- `page` string
- `limit` string

## Response `200`

Paginated audit events and accessible companies

## Other responses

- `403`: Not an active firm member, or company not accessible
- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)