---
title: "List Audit Logs"
method: GET
path: "/audit_events"
tags: ["Audit Logs"]
---

# List Audit Logs

`GET /audit_events`

Retrieve a list of audit log entries. Audit logs are a best-effort, eventually consistent record of significant account-related changes.

## Query parameters

- `page` object
  - `number` integer — Page number to load.
  - `size` integer — Number of items per page.
- `filter` object
  - `created_after` string, date-time — Filter for audit events created after a specific date.
  - `created_before` string, date-time — Filter for audit events created before a specific date.
- `sort` 'asc' | 'desc'

## Response `200`

A list of audit log entries.

- AuditLogList
  - `data` AuditLog[]
    - `alternate_resource_id` string, nullable — An alternate identifier for a resource which may be considered unique enough to identify the resource but is not the primary identifier for the resource. For example, this field could be used to store the phone number value for a phone number when the primary database identifier is a separate distinct value.
    - `change_made_by` 'telnyx' | 'account_manager' | 'account_owner' | 'organization_member' — Indicates if the change was made by Telnyx on your behalf, the organization owner, a member of your organization, or in the case of managed accounts, the account manager.
    - `change_type` string — The type of change that occurred.
    - `changes` AuditEventChanges[], nullable — Details of the changes made to the resource.
      - `field` string — The name of the field that was changed. May use the dot notation to indicate nested fields.
      - `from` union — The previous value of the field. Can be any JSON type.
        - string
        - number
        - boolean
        - object
        - unknown[]
          - unknown
      - `to` union — The new value of the field. Can be any JSON type.
        - string
        - number
        - boolean
        - object
        - unknown[]
          - unknown
    - `created_at` string, date-time — ISO 8601 formatted date indicating when the change occurred.
    - `id` string, uuid — Unique identifier for the audit log entry.
    - `organization_id` string, uuid — Unique identifier for the organization that owns the resource.
    - `record_type` string — The type of the resource being audited.
    - `resource_id` string — Unique identifier for the resource that was changed.
    - `user_id` string, uuid — Unique identifier for the user who made the change.
  - `meta` AuditLogsPaginationMeta
    - `page_number` integer
    - `page_size` integer
    - `total_pages` integer
    - `total_results` integer

## Other responses

- `401` — Unexpected error.
- `default` — Unexpected error.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)