---
title: "Get audit Logs"
method: GET
path: "/api/{cloudId}/v1/logs"
tags: ["Audit Logs"]
---

# Get audit Logs

`GET /api/{cloudId}/v1/logs`

This endpoint returns all operations audit logs in Jira Service Management, allowing retrieval of logs in a specified time range and  filtering based on log level and category. <br> <br> **Permissions required:** Permission to view Jira Service Management Audit logs using a JSM Org/Site/Product admin role

## Query parameters

- `limit` integer
- `pageToken` string
- `category` 'AUTOMATION' | 'INCOMING_DATA' | 'ALERTS' | 'API' | 'CONFIG_CHANGE' | 'EMAIL' | 'HEARTBEAT' | 'INCIDENT_MANAGEMENT' | 'INTEGRATION' | 'SYNC' | 'NOTIFICATION' | 'ONCALL_MANAGEMENT' | 'SERVICE' | 'USER_IMPORT' | 'ADD_USER_TO_GROUP' | 'ADD_USER_TO_ROLE'
- `level` 'INFORTMATION' | 'ERROR' | 'WARN'
- `startTime` string, date-time, required
- `endTime` string, date-time, required

## Response `200`

This message is returned if the request is successful.

- ListAuditLogResponse
  - `values` AuditLogResponse[] — List of Audit logs.
    - `created` string, date-time — Exact date and time when the audit log was generated.
    - `message` string — Summary message for the audit log.
    - `details` string — Details of the audit log in JSON string format.
    - `category` 'Automation' | 'Incoming Data' | 'Alerts' | 'API' | 'Configuration Changes' | 'Emails' | 'Heartbeats' | 'Incident Management' | 'Integrations' | 'Syncs' | 'Notifications' | 'Oncall Management' | 'Services' | 'User Import' | 'Added user to group' | 'Added user to role' — Represents category of the audit log like Alerts, Notifications etc.
    - `level` 'Information' | 'Error' | 'Warning' — Log level of the audit log.
  - `count` integer — Total number of audit logs in response.
  - `links` ListAuditLogResponseLink
    - `next` string — Link to the next page of results. This will be null when all logs have been returned

## Other responses

- `400` — Returned if the required request parameters are missing, or if any of them are incorrectly formed
- `401` — Returned if the authentication credentials are incorrect or if a user with insufficient permissions is attempting to fetch the audit logs.

---

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