# Audit Logs

## List Audit Logs

> List audit logs for the organization with keyset pagination. Audit logs provide an audit trail of significant events within Opine. Supports filtering by activity type, deal, actor user, and target user.. Requires the 'activity\_logs:read' scope.

```json
{"openapi":"3.0.1","info":{"title":"Opine API","version":"1.0.0"},"servers":[{"url":"https://api.tryopine.com","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication"}},"schemas":{"ListAuditLogs200ResponseBody":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"occurredAt":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"organizationId":{"type":"number"},"dealId":{"nullable":true,"type":"number"},"evaluationId":{"nullable":true,"type":"number"},"actorUserId":{"nullable":true,"type":"number"},"targetUserId":{"nullable":true,"type":"number"},"modifiedTargetUserId":{"nullable":true,"type":"number"},"metadata":{"nullable":true,"type":"object","additionalProperties":{}},"organization":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"evaluation":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"title":{"type":"string"},"deal":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"required":["id","title"],"additionalProperties":false},"deal":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"actorUser":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"firstName":{"nullable":true,"type":"string"},"lastName":{"nullable":true,"type":"string"},"profileImageUrl":{"nullable":true,"type":"string"}},"required":["id","firstName","lastName","profileImageUrl"],"additionalProperties":false},"targetUser":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"firstName":{"nullable":true,"type":"string"},"lastName":{"nullable":true,"type":"string"},"profileImageUrl":{"nullable":true,"type":"string"}},"required":["id","firstName","lastName","profileImageUrl"],"additionalProperties":false},"modifiedTargetUser":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"firstName":{"nullable":true,"type":"string"},"lastName":{"nullable":true,"type":"string"},"profileImageUrl":{"nullable":true,"type":"string"}},"required":["id","firstName","lastName","profileImageUrl"],"additionalProperties":false},"task":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"title":{"type":"string"},"type":{"nullable":true,"type":"string"}},"required":["id","title","type"],"additionalProperties":false},"requirement":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"title":{"type":"string"}},"required":["id","title"],"additionalProperties":false},"meeting":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"title":{"type":"string"}},"required":["id","title"],"additionalProperties":false},"ticket":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"title":{"type":"string"}},"required":["id","title"],"additionalProperties":false},"teamRequest":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"status":{"type":"string"},"teamRequestType":{"nullable":true,"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"required":["id","status","teamRequestType"],"additionalProperties":false}},"required":["id","type","occurredAt","createdAt","updatedAt","organizationId","dealId","evaluationId","actorUserId","targetUserId","modifiedTargetUserId","metadata","organization","evaluation","deal","actorUser","targetUser","modifiedTargetUser","task","requirement","meeting","ticket","teamRequest"],"additionalProperties":false}},"startCursor":{"nullable":true,"type":"string"},"endCursor":{"nullable":true,"type":"string"},"hasPrevious":{"type":"boolean"},"hasMore":{"type":"boolean"}},"required":["items","startCursor","endCursor","hasPrevious","hasMore"],"additionalProperties":false},"ErrorMessage":{"type":"object","properties":{"message":{"type":"string"}},"additionalProperties":false}}},"paths":{"/v1/audit-logs":{"get":{"operationId":"listAuditLogs","responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAuditLogs200ResponseBody"}}}},"500":{"description":"An unknown error occurred, trying again might help.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"List Audit Logs","description":"List audit logs for the organization with keyset pagination. Audit logs provide an audit trail of significant events within Opine. Supports filtering by activity type, deal, actor user, and target user.. Requires the 'activity_logs:read' scope.","tags":["audit-logs"],"parameters":[{"name":"limit","in":"query","description":"Number of items to return (1-1000, default 100)","required":false,"schema":{"type":"number","minimum":1,"maximum":1000,"default":100}},{"name":"before","in":"query","description":"Cursor for pagination. Use endCursor from a previous response to get the next page of older logs.","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","description":"Cursor to poll for new logs. Use startCursor from a previous response to get logs created after that point.","required":false,"schema":{"type":"string"}},{"name":"activityTypes","in":"query","description":"Filter by activity type(s). Accepts single value or array (activityTypes[]=TYPE1&activityTypes[]=TYPE2)","required":false,"schema":{"type":"string"}},{"name":"dealIds","in":"query","description":"Filter by deal ID(s). Accepts single value or array (dealIds[]=1&dealIds[]=2). Invalid IDs are silently ignored.","required":false,"schema":{"type":"number"}},{"name":"actorUserEmails","in":"query","description":"Filter by actor user email(s). Accepts single value or array (actorUserEmails[]=email1&actorUserEmails[]=email2)","required":false,"schema":{"type":"string"}},{"name":"targetUserEmails","in":"query","description":"Filter by target user email(s). Accepts single value or array (targetUserEmails[]=email1&targetUserEmails[]=email2)","required":false,"schema":{"type":"string"}}]}}}}
```