> ## Documentation Index > Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt > Use this file to discover all available pages before exploring further. # Get audit logs. > Retrieve system audit logs with optional filtering, keyword search, and pagination. Logs can be filtered by event types, affected resources, user ID, user email, date range (start date and end date), and a free-text keyword. ## OpenAPI ````yaml /openapi/adm.openapi.en-dev.json get /api/manager/logs openapi: 3.1.0 info: description: > ## Introduction The Data Management APIs comprehensively oversees the **diverse data** used by advertising and recommendation systems, ensuring that the Decision API runs accurately and efficiently. From registering, updating, and deleting campaigns and placements to **log and statistics analysis**, it provides the insights necessary for effective system operation. The resulting data and metrics are used by the Decision API to **optimize ad and content decisions**, ultimately boosting the overall performance of the advertising and recommendation system. title: Data Management APIs version: dev servers: [] security: [] tags: - description: >- Authentication endpoints. All roles (admin, operator, advertiser) use these to log in, refresh tokens, and manage their own credentials. name: Auth - description: >- Advertiser account management. Operators and admins onboard advertisers, manage their budgets, and deactivate accounts. Advertisers can only read their own profile and balance — they cannot create, delete, or modify another advertiser's account. name: Advertisers - description: >- Internal user (operator / admin) account management. Admin only. Covers creating operator accounts, changing roles, toggling activation status, and hard-deleting accounts. Operators have no access to this resource. name: Users - description: >- The AdUnit Management API provides comprehensive functionalities for managing ad units and related resources. AdUnits are organized in a hierarchical path structure derived from their code and parent path. Only admin and operator roles have access — advertisers cannot access raw inventory. References: [Placement](https://docs.aiderx.io/guides/about-a2/en/placement) name: AdUnit - description: >- Ad catalog management. CRUD for ad catalogs plus public shared-view access via a share link. name: Ad Catalogs - description: >- Ad source (demand partner) management. CRUD for external ad sources that supply demand to ad units. name: AdSource - description: >- Allocation management. An allocation binds a line item to a serving target such as an ad unit. Covers CRUD, status counts, and single-allocation lookup. name: Allocations - description: >- Associated items pool (admin). Bulk upsert/delete and lookup of associated-items pools used by the recommendation pipeline. name: AssociatedItemsPool - description: >- Custom targeting segment management. CRUD and bulk operations for custom targeting segments. name: Custom Targeting Segment - description: Audit log access. Read the system audit log of administrative actions. name: Audit Logs - description: >- Creative block list. List, block, and unblock creatives to exclude them from serving. name: Blocked Creative - description: Catalog item management. List and update catalog (product/data) items. name: Catalogs - description: >- Creative asset management. Operators and admins manage creatives; advertisers see only their own. Deletion is blocked while any line-item association (LICA) still exists. name: Creatives - description: >- Dashboard aggregates. Summary data, inventory, and line-item metric rollups for the console dashboard. name: Dashboard - description: Experiment management. CRUD for A/B and optimization experiments. name: Experiment - description: >- External creative inspection. Read-only access to creatives ingested from external demand sources. name: External Creative - description: >- Third-party integration management. Manage integration sources (external data/serving connectors), probe connectivity, and read public (sensitive-config-redacted) configs. name: Integration - description: >- Line Item–Creative Associations (LICA). Associates creatives with line items, including batch create and delete (max 100, partial failure allowed) and dashboard counts. name: LICAs - description: License information. Read available license features and usage metrics. name: License - description: >- Line item management within an order. Covers create, update, delete, batch operations (max 100, partial failure allowed), and status transitions. A line item defines budget, goal, schedule, and targeting under its parent order. name: LineItems - description: Media library. List, upload, and delete media files used by creatives. name: Media Library - description: >- Metric query endpoints. Retrieve aggregated metrics for ad units, creatives, line items, and related entities. name: Metric - description: >- Advertiser order management. Operators and admins create and manage orders that group line items under a single budget; advertisers can read their own. Includes batch operations (max 100) and draft-only deletion rules. name: Orders - description: >- Placement management. A placement maps ad units to a serving surface. Endpoints cover CRUD and replacing the ad units bound to a placement. name: Placements - description: >- System settings. Read and update system configuration, including site logo, public URL, TLS, and access-token regeneration. name: Settings - description: System resources. Public static resources such as the site logo. name: System - description: >- Operational/developer control endpoints. Low-level ext patches and health checks intended for internal operation, not general API consumers. name: developer - description: >- Operational allocation control. Update allocation ext or force-update status (admin only). name: developer/control/allocations - description: >- Ad-serving monitoring (operational). Read ad-serving status, ad-unit monitoring history, and alerts. name: developer/monitoring - description: Internal health and probe endpoints. name: internal - description: >- Manager-level utility endpoints (e.g. service health) not tied to a specific resource. name: manager - description: Manage mappings between ad units, native formats, and native styles. name: Ad Unit Native Style - description: Manage custom targeting keys, including lifecycle and bulk operations. name: Custom Targeting Key - description: >- Manage values belonging to custom targeting keys, including lifecycle and bulk operations. name: Custom Targeting Value - description: Manage native formats and the fields that define each format. name: Native Format - description: List templates available for native styles. name: Native Style Template - description: Manage native rendering styles. name: Native Style paths: /api/manager/logs: get: tags: - Audit Logs summary: Get audit logs. description: >- Retrieve system audit logs with optional filtering, keyword search, and pagination. Logs can be filtered by event types, affected resources, user ID, user email, date range (start date and end date), and a free-text keyword. operationId: handle_list_audit_logs_api_manager_logs_get parameters: - description: Page number (1-based). in: query name: page required: false schema: default: 1 description: Page number (1-based). minimum: 1 title: Page type: integer - description: Number of items per page. in: query name: page_size required: false schema: default: 100 description: Number of items per page. maximum: 100 minimum: 1 title: Page Size type: integer - description: Field name to sort by. in: query name: sort_by required: false schema: default: timestamp description: Field name to sort by. enum: - timestamp - id - event_type - user_email title: Sort By type: string - description: Sort direction. in: query name: sort_order required: false schema: $ref: '#/components/schemas/SortOrder' default: desc description: Sort direction. - in: query name: event_types required: false schema: anyOf: - items: type: string type: array - type: 'null' title: Event Types - description: Restrict to these affected_resource values. in: query name: affected_resources required: false schema: anyOf: - items: type: string type: array - type: 'null' description: Restrict to these affected_resource values. title: Affected Resources - in: query name: user_id required: false schema: anyOf: - format: uuid type: string - type: 'null' title: User Id - in: query name: user_email required: false schema: anyOf: - type: string - type: 'null' title: User Email - in: query name: start_date required: false schema: anyOf: - format: date-time type: string - type: 'null' title: Start Date - in: query name: end_date required: false schema: anyOf: - format: date-time type: string - type: 'null' title: End Date - description: >- Search keyword across event_type/description/user_email/affected_resource. in: query name: keyword required: false schema: anyOf: - type: string - type: 'null' description: >- Search keyword across event_type/description/user_email/affected_resource. title: Keyword responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_AuditLogResponse_' description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - HTTPBearer: [] components: schemas: SortOrder: enum: - asc - desc title: SortOrder type: string PaginatedResponse_AuditLogResponse_: properties: items: items: $ref: '#/components/schemas/AuditLogResponse' title: Items type: array pagination: $ref: '#/components/schemas/PageInfo' required: - items - pagination title: PaginatedResponse[AuditLogResponse] type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object AuditLogResponse: properties: affected_resource: anyOf: - type: string - type: 'null' description: The identifier of the resource that was modified title: Affected Resource description: anyOf: - type: string - type: 'null' description: The detailed description of the event title: Description event_type: description: The type of event that triggered this audit log title: Event Type type: string id: description: The id of the audit log entry title: Id type: integer new_value: anyOf: - additionalProperties: true type: object - type: 'null' description: The resource state after the change title: New Value old_value: anyOf: - additionalProperties: true type: object - type: 'null' description: The resource state before the change title: Old Value timestamp: description: The datetime when this audit log entry was created format: date-time title: Timestamp type: string user_email: description: The email address of the user who performed the action title: User Email type: string user_id: description: The id of the user who performed the action format: uuid title: User Id type: string required: - id - event_type - user_id - user_email - timestamp title: AuditLogResponse type: object PageInfo: properties: page: title: Page type: integer page_size: title: Page Size type: integer total: title: Total type: integer total_pages: title: Total Pages type: integer required: - total - page - page_size - total_pages title: PageInfo type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object securitySchemes: HTTPBearer: description: >- Bearer authentication. Pass the access token in the `Authorization: Bearer ` header. scheme: bearer type: http ````