# Lodger

> Audit evidence infrastructure for event receipts, consent history, policy versions, and portable evidence exports.

## Docs

- [AI Agent Docs](https://docs.lodger.dev/ai-agents/overview.md): Use Lodger documentation, SDKs, and HTTP references from AI coding agents safely.
- [Agent Playbook](https://docs.lodger.dev/ai-agents/playbook.md): Step-by-step instructions AI agents can follow when adding Lodger to an application.
- [Create a policy token](https://docs.lodger.dev/api-reference/create-a-policy-token.md): Creates a signed token for reading a private published policy page. Dashboard sessions and API keys with events:read access can mint tokens for projects they are allowed to read.
- [Create a receipt token](https://docs.lodger.dev/api-reference/create-a-receipt-token.md): Creates a signed token for verifying one private receipt. Dashboard sessions and API keys with events:read access can mint tokens for receipts they are allowed to read.
- [Create an activity token](https://docs.lodger.dev/api-reference/create-an-activity-token.md): Creates a signed, workspace-scoped, project-scoped, subject-scoped token for customer-facing activity views. API keys need the `events:read` scope.
- [Create an evidence token](https://docs.lodger.dev/api-reference/create-an-evidence-token.md): Creates a signed token for one evidence package. The token can open the verifier, download the package, and verify private receipts included in that package.
- [Download an evidence package](https://docs.lodger.dev/api-reference/download-an-evidence-package.md): Downloads one completed evidence ZIP. Dashboard sessions, read-capable API keys, and scoped evidence tokens can access the package.
- [Get a policy version](https://docs.lodger.dev/api-reference/get-a-policy-version.md): Returns a published policy snapshot. Public project policies can be read without auth. Private project policies require a dashboard session, a read-capable API key, or a scoped policy token.
- [Get current policy](https://docs.lodger.dev/api-reference/get-current-policy.md): Returns a published policy snapshot. Public project policies can be read without auth. Private project policies require a dashboard session, a read-capable API key, or a scoped policy token.
- [Health check](https://docs.lodger.dev/api-reference/health-check.md): Confirms the API process is reachable.
- [Query retained records](https://docs.lodger.dev/api-reference/query-retained-records.md): Lists retained ledger entries for a workspace. API keys need the `events:read` scope.
- [Read tokenized activity](https://docs.lodger.dev/api-reference/read-tokenized-activity.md): Returns user-visible records for the subject embedded in a signed activity token. The token is scoped to one workspace, one project, and one subject, and the project must allow activity links.
- [Record consent](https://docs.lodger.dev/api-reference/record-consent.md): Records explicit or implicit consent against the current published policy version.
- [Verify a receipt](https://docs.lodger.dev/api-reference/verify-a-receipt.md): Returns the receipt, matching ledger entry, and verification status. Public project receipts can be verified by receipt ID. Private project receipts require a dashboard session, a read-capable API key, a scoped receipt token, or an evidence token for a package that includes the receipt.
- [Verify a receipt globally](https://docs.lodger.dev/api-reference/verify-a-receipt-globally.md): Returns the receipt, matching ledger entry, and verification status. Public project receipts can be verified by receipt ID. Private project receipts require a dashboard session, a read-capable API key, a scoped receipt token, or an evidence token for a package that includes the receipt.
- [Write an audit event](https://docs.lodger.dev/api-reference/write-an-audit-event.md): Appends one event to the workspace ledger and returns a portable receipt.
- [Evidence Exports](https://docs.lodger.dev/evidence/exports.md): Understand Lodger evidence ZIPs, batching, scope, and archive-safe export behavior.
- [Receipts](https://docs.lodger.dev/evidence/receipts.md): Use Lodger receipts as durable citations for individual audit events.
- [Verify Evidence](https://docs.lodger.dev/evidence/verify.md): Verify a Lodger evidence package locally without one backend call per event.
- [Concepts](https://docs.lodger.dev/get-started/concepts.md): Understand workspaces, projects, events, receipts, policies, consent, and evidence exports.
- [Quickstart](https://docs.lodger.dev/get-started/quickstart.md): Create a project, issue an API key, record an event, and verify the receipt.
- [Lodger Docs](https://docs.lodger.dev/index.md): Build credible audit trails with event receipts, policy versions, consent history, and evidence exports.
- [Billing](https://docs.lodger.dev/ops/billing.md): Choose the right Lodger plan for development, production, scale, and enterprise evidence needs.
- [Environments](https://docs.lodger.dev/ops/environments.md): Separate local, test, staging, and production evidence without losing provenance.
- [Limits](https://docs.lodger.dev/ops/limits.md): Understand event volume, retention, payload, pagination, and archive query limits.
- [Authentication](https://docs.lodger.dev/reference/authentication.md): Authenticate Lodger HTTP requests with scoped API keys.
- [Errors](https://docs.lodger.dev/reference/errors.md): Handle Lodger API errors, idempotency problems, scope failures, and archive confirmations.
- [HTTP Overview](https://docs.lodger.dev/reference/overview.md): Use the Lodger HTTP API directly when an SDK is not available.
- [Event Catalog](https://docs.lodger.dev/sdk/event-catalog.md): Define stable event names so integrations stay consistent and easy to review.
- [Server Patterns](https://docs.lodger.dev/sdk/server-patterns.md): Integrate Lodger safely from request handlers, jobs, webhooks, and customer activity surfaces.
- [TypeScript SDK](https://docs.lodger.dev/sdk/typescript.md): Use the Lodger TypeScript SDK from Node, Bun, Workers, and server-side web runtimes.

## OpenAPI Specs

- [openapi](https://docs.lodger.dev/openapi.json)