---
title: "Get Notification Policies"
method: GET
path: "/notification_policies"
tags: ["Portfolio Monitoring"]
---

# Get Notification Policies

`GET /notification_policies`

Get all notification policies in the organization with pagination.
Policies are sorted by created_at in ascending order.

## Query parameters

- `limit` integer — Maximum number of records to return in a single page. Must be between 1 and 1000.
- `offset` integer, nullable — Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.
- `cursor` string, nullable — Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset.

## Response `200`

Response

- V1NotificationPolicyListResponse[]
  - `id` string, uuid, required — The unique identifier of the notification policy.
  - `scope` 'portfolio' | 'group' | 'item', required — The scope of a portfolio monitoring policy.
  - `name` string, required — The name of the notification policy.
  - `item_id` string, uuid, nullable, required — The unique identifier of the portfolio item, if any.
  - `group_id` string, uuid, nullable, required — The unique identifier of the portfolio group, if any.
  - `enabled` boolean, required — Whether the notification policy is enabled.
  - `cadence` 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'biannually' | 'annually', required — The cadence of monitoring.
  - `last_run_at` string, date-time, nullable — When the notification policy was last executed.
  - `next_run_on` string, date-time, nullable — When the notification policy will be executed next.
  - `attributes` V1NotifiableAttributes[] — The attributes to notify on.
  - `url` string, required
  - `group_url` string, nullable, required
  - `item_url` string, nullable, required

## Other responses

- `422` — Validation Error

---

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