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

# List Audit Logs

`GET /auditlogs`

## Request

- Base URL: `https://api.upstash.com`
- URL: `https://api.upstash.com/auditlogs`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/upstash/apis/developer-api-upstash/docs/auditlogs/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint lists all audit logs of user.

## Response `200`

Audit logs retrieved successfully

- AuditLog[]
  - `log_id` string: Unique identifier for the log entry
  - `customer_id` string: The ID or email of the customer associated with the log
  - `actor` string: The user or system that performed the action
  - `timestamp` integer: Unix timestamp of when the action occurred
  - `action` integer: Numeric ID representing the specific action type
  - `action_string` string: Human-readable description of the action
  - `source` string: The source method or client used to perform the action
  - `entity` string: The primary entity affected by the action
  - `secondary_entity` string: A secondary entity affected, "" or "NA" if not applicable
  - `third_entity` string: A tertiary entity affected, "" or "NA" if not applicable
  - `readable_format` string: formatted string for display purposes
  - `ip` string, ipv4: The IP address from which the request originated
  - `ttl` integer: Time to live (expiration) timestamp for this log entry
  - `reason` string: The reason for the action, if provided
  - `notes` string: Additional notes regarding the action

---

[API](https://skmtc.dev/upstash/apis/developer-api-upstash.md) - [All operations](https://skmtc.dev/upstash/apis/developer-api-upstash/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/developer-api-upstash/revisions/bddbdcab9052?raw)