> ## Documentation Index > Fetch the complete documentation index at: https://docs.useanima.sh/llms.txt > Use this file to discover all available pages before exploring further. # Get orgs audit logs ## OpenAPI ````yaml /openapi.json get /orgs/{orgId}/audit-logs openapi: 3.1.1 info: title: Anima API version: 0.1.0 description: >- The Anima API provides programmatic access to unified infrastructure for AI agents: create and manage agents; send and receive email; place phone calls and send/receive SMS and voice; store and retrieve vault credentials; manage agent identity; and configure webhooks for real-time events. Authenticate using a Bearer token or an API key passed via the X-API-Key header. contact: name: Anima Labs url: https://useanima.sh email: support@useanima.sh license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.useanima.sh/v1 description: Production security: - BearerAuth: [] - ApiKeyAuth: [] tags: - name: Agents description: Create and manage AI agents with email and phone capabilities - name: Inboxes description: Manage email inboxes and their configurations - name: Messages description: Send, receive, and search email messages - name: Webhooks description: Register and manage webhook subscriptions for real-time events - name: Organizations description: Manage organizations and team settings - name: Domains description: Configure and verify custom email domains - name: Phone description: Manage phone numbers and SMS/voice capabilities - name: Invoices description: Track invoices, match receipts, and reconcile payments - name: Billing description: View usage, tiers, and billing information - name: Security description: Configure security policies and access controls - name: Vault description: Store and retrieve encrypted secrets - name: API Keys description: Create and manage API keys for programmatic access paths: /orgs/{orgId}/audit-logs: get: operationId: audit.listLogs parameters: - name: orgId in: path required: true schema: type: string description: Organization identifier - name: actorId in: query required: false schema: type: string description: Filter by actor identifier allowEmptyValue: true allowReserved: true - name: actorType in: query required: false schema: enum: - API_KEY - USER - SYSTEM - AGENT type: string description: Filter by actor type allowEmptyValue: true allowReserved: true - name: action in: query required: false schema: type: string description: Filter by action allowEmptyValue: true allowReserved: true - name: resourceType in: query required: false schema: type: string description: Filter by resource type allowEmptyValue: true allowReserved: true - name: resourceId in: query required: false schema: type: string description: Filter by resource identifier allowEmptyValue: true allowReserved: true - name: result in: query required: false schema: enum: - SUCCESS - FAILURE - DENIED type: string description: Filter by result allowEmptyValue: true allowReserved: true - name: startDate in: query required: false schema: type: string description: ISO 8601 start date filter allowEmptyValue: true allowReserved: true - name: endDate in: query required: false schema: type: string description: ISO 8601 end date filter allowEmptyValue: true allowReserved: true - name: cursor in: query required: false schema: type: string description: Pagination cursor allowEmptyValue: true allowReserved: true - name: limit in: query required: false schema: default: 20 type: integer minimum: 1 maximum: 100 description: Maximum number of entries to return allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string description: Unique audit log entry identifier orgId: type: string description: Organization identifier actorType: enum: - API_KEY - USER - SYSTEM - AGENT type: string description: Type of actor that performed the action actorId: type: string description: Identifier of the actor action: type: string description: Action performed (e.g. agent.create) resourceType: type: string description: Type of resource acted upon resourceId: type: string description: Identifier of the resource result: enum: - SUCCESS - FAILURE - DENIED type: string description: Result of the audited action ipAddress: anyOf: - type: string - type: 'null' description: IP address of the request userAgent: anyOf: - type: string - type: 'null' description: User-Agent header value metadata: anyOf: - type: object additionalProperties: {} - type: 'null' description: Additional structured metadata createdAt: type: string description: ISO 8601 timestamp of the event required: - id - orgId - actorType - actorId - action - resourceType - resourceId - result - ipAddress - userAgent - metadata - createdAt description: An immutable audit log entry description: List of audit log entries nextCursor: anyOf: - type: string - type: 'null' description: Cursor for the next page, null if no more results totalCount: type: integer description: Total number of entries matching the filters required: - items - nextCursor - totalCount description: Paginated list of audit log entries components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer ApiKeyAuth: type: apiKey in: header name: X-API-Key description: 'API key for programmatic access. Pass as: X-API-Key: ' ````