---
title: "Get Portfolio Item Notification Policies"
method: GET
path: "/portfolio/items/{item_id}/notification_policies"
tags: ["Portfolio Monitoring"]
---

# Get Portfolio Item Notification Policies

`GET /portfolio/items/{item_id}/notification_policies`

## Request

- Base URL: `https://api.baselayer.com`
- URL: `https://api.baselayer.com/portfolio/items/{item_id}/notification_policies`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/baselayer/apis/baselayer-api-service/docs/portfolio/items/:item_id/notification_policies/get.ts> (a function with typed inputs; its response is checked against the schema)

Get notification policies directly bound to a portfolio item.

## Path parameters

- `item_id` string, uuid, required

## Response `200`

Response

- V1NotificationPolicyResponse[]
  - `id` string, uuid, required: The unique identifier of the notification policy.
  - `type` string, required: The type of notification policy (email, slack, webhook).
  - `name` string, required: The name of the notification policy.
  - `group_id` string, uuid, nullable: The unique identifier of the portfolio group (if applicable).
  - `item_id` string, uuid, nullable: The unique identifier of the portfolio item (if applicable).
  - `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, nullable: When the notification policy is scheduled to run next.
  - `attributes` V1NotifiableAttributes[]: List of attributes to notify on (officers, alternative_names).
  - `recipients` string[]: List of email recipients for email notification policies.
  - `created_at` string, date-time, required: When the notification policy was created.
  - `updated_at` string, date-time, nullable: When the notification policy was last updated.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/baselayer/apis/baselayer-api-service.md) - [All operations](https://skmtc.dev/baselayer/apis/baselayer-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/baselayer/apis/baselayer-api-service/revisions/0cc89938bc26?raw)