> For the complete documentation index, see [llms.txt](https://docs.adaptria.locaria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptria.locaria.com/internal-api/reference/audit.md).

# 🛡️ Audit

### Audit (Admin)

Read audit logs for compliance and observability integrations. Admin-only — client API keys receive `403`.

## 🛡️ Get Audit Logs

> Retrieve audit logs with filtering and pagination. Mirrors \`GET /api/admin/audit/logs\`. Admin-only — client API keys → 403.

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"🛡️ Audit","description":"## Audit (Admin)\n\nRead audit logs for compliance and observability integrations. Admin-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicAuditLogsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{}}},"meta":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"totalPages":{"type":"number"},"hasNextPage":{"type":"boolean"},"hasPreviousPage":{"type":"boolean"}},"required":["page","limit","total","totalPages","hasNextPage","hasPreviousPage"]},"filters":{"type":"object","additionalProperties":{}},"timestamp":{"type":"string"},"version":{"type":"string"}},"required":["pagination","filters","timestamp","version"]},"success":{"type":"boolean"}},"required":["data","meta","success"]}}},"paths":{"/api/public/v1/admin/audit/logs":{"get":{"summary":"🛡️ Get Audit Logs","description":"Retrieve audit logs with filtering and pagination. Mirrors `GET /api/admin/audit/logs`. Admin-only — client API keys → 403.","tags":["🛡️ Audit"],"parameters":[{"schema":{"type":"string","pattern":"^\\d+$"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","pattern":"^\\d+$"},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"domain","in":"query"},{"schema":{"type":"string"},"required":false,"name":"category","in":"query"},{"schema":{"type":"array","items":{"type":"string"}},"required":false,"name":"categories","in":"query"},{"schema":{"type":"string"},"required":false,"name":"action","in":"query"},{"schema":{"type":"array","items":{"type":"string"}},"required":false,"name":"events","in":"query"},{"schema":{"type":"string","format":"uuid"},"required":false,"name":"userId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"serviceName","in":"query"},{"schema":{"type":"string"},"required":false,"name":"team","in":"query"},{"schema":{"type":"array","items":{"type":"string"}},"required":false,"name":"teams","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"},{"schema":{"type":"string","enum":["timestamp","type","userId","userName","serviceName","eventName","receivedAt"]},"required":false,"name":"sortBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"]},"required":false,"name":"order","in":"query"}],"responses":{"200":{"description":"Audit logs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAuditLogsResponse"}}}},"401":{"description":"Unauthorised"},"403":{"description":"Forbidden"}}}}}}
```