---
title: "List alert templates"
method: GET
path: "/api/v1/alerts"
tags: ["Alert", "Public API"]
---

# List alert templates

`GET /api/v1/alerts`

Returns all available alert templates with their IDs, names, and group names. Use the returned IDs when creating or updating company alert configurations.

OAuth Scopes: alerts

## Response `200`

List of alert templates

- object
  - `alerts` object[]
    - `id` integer — Alert template ID (bambooAlertId)
    - `name` string — Display name of the alert
    - `groupName` string — Category group the alert belongs to

## Other responses

- `403` — Forbidden
- `500` — Internal server error

---

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