---
title: "List alert logs"
method: GET
path: "/api/{cloudId}/v1/alerts/{id}/logs"
tags: ["Alerts"]
---

# List alert logs

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

This endpoint is used to retrieve a paginated list of alert logs which provides users to obtain a comprehensive record of alert activities. This includes alert creation, acknowledgment, assignment, and closure details. This endpoint is crucial for audit purposes, incident reviews, and enhancing the overall incident management process by providing complete visibility into alert history.

## Path parameters

- `id` string, required

## Query parameters

- `after` string
- `size` integer

## Response `200`

Returned if the request is successful.

- AlertLogsResponse
  - `values` AlertLog[]
    - `logTime` string, date-time — Represents the timestamp at which the alert log was generated.
    - `logType` string — Represents the type of the log. The value is a string that describes the nature of the alert activity.
    - `log` string — Represents the actual log message. The value is a string that provides detailed information about the alert activity.
    - `owner` string — Represents the entity that initiated the alert activity. The value is a string that could be a user, team, or system that carried out the action logged.
  - `links` AlertLogLink
    - `next` string — Link to the next page of results.

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the request user does not have read-only permission for alerts.
- `404` — Returned if the alert is not found.
- `422` — Returned if the payload cannot be validated.

---

[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)