---
title: "List audit log entries by Organization"
method: GET
path: "/orgs/{orgId}/audit-logs"
tags: ["public", "AuditLogs"]
---

# List audit log entries by Organization

`GET /orgs/{orgId}/audit-logs`

List all available audit log entries in the Organization that match the specified filters. This API returns entries from newest to oldest and is paginated. Only successful create, modify, or delete requests are stored in  the audit log. This API may return a lot of data, depending on the size of the Organization, so it is  recommended to use the "to" and "from" query parameters to limit the returned data to the time window of interest. Each response contains at most 32 days worth of data for performance reasons and may be empty if no records exist within that time range. Pagination links in the 'Link' header should always be followed when present.
This API requires administrator permissions in the Organization.

## Path parameters

- `orgId` string, required

## Query parameters

- `per_page` integer
- `page` string
- `from` string, date-time
- `to` string, date-time

## Response `200`

Successful list response.

- AuditLogEntry[]
  - `at` string, date-time, required — The date and time when the event was recorded.
  - `org_id` string — The id of the Organization this event occurred in.
  - `user_id` string, required — The id of the User who triggered the event.
  - `request_method` string, required — The HTTP method that was requested. Only POST, PATCH, PUT, and DELETE are audited.
  - `request_path` string, required — The URL path that was called.
  - `response_status` integer, required — The status code of the response. Only successful responses are audited.

## Other responses

- `400` — The request was invalid. More detail can be found in the error body.
- `403` — Server understands the request but refuses to authorize it.
- `404` — Either the resource or a related resource could not be found. More detail can be found in the error body.

---

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