---
title: "Audit & Meta"
description: "Query the append-only audit trail by record, actor or date, plus the metadata endpoints that describe how your organization is configured."
url: "https://bareledger.app/guides/api-audit"
category: "Developers & API"
updated: "2026-10-04"
publisher: "BareLedger (Syneria Technologies OPC)"
---

# Audit & Meta

> Query the append-only audit trail by record, actor or date, plus the metadata endpoints that describe how your organization is configured.

| Method & Path | Permission | Purpose |
|---|---|---|
| `GET audit-logs` | `audit.view` | Paginated tenant audit log, filterable by event |
| `GET search` | Enforced per-module inside the API | Global or module-scoped search |
| `GET notifications` | — | User's own notifications, paginated/filterable |
| `POST notifications/read-all` | — | Mark all own notifications read |
| `POST notifications/{notification}/read` | — | Mark one notification read |
| `GET notifications/preferences` / `PUT notifications/preferences` | — | Notification channel preferences |
| `GET dashboard` | — (financials gated by `report.view`, audit feed by `audit.view` inside the method) | Role-aware summary: permissions, team count, financials (nulled if unauthorized), per-module review/approval/rejected queue counts, recent audit activity |