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

# Get Portfolio Item Notifications

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

Retrieves all changes for a portfolio item across all snapshots.

Returns a list of DiffChange objects representing all changes
between consecutive snapshots for the portfolio item.

## Path parameters

- `item_id` string, uuid, required — The unique identifier of the portfolio item to get notifications for.

## 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

- V1PortfolioMonitoringNotificationResponse[]
  - `message` V1StructuredText, required — This class represents a structured text in the application. StructuredText is used to annotate individual parts of the text with semantic types. This is helpful to the UI for stylized rendering. It provides a way to structure the text in a way that can be easily understood and manipulated by the UI.
    - `components` V1TextComponent[], required — The structured text annotates individual parts of the text with semantic types, which is helpful to the UI for stylized rendering.
      - `type` 'regular' | 'subject' | 'value' | 'label' | 'actor', required — SemanticType is an enumeration of the different types of semantic segments that a text can have. It is used to structure and annotate text in a way that can be helpful for stylized rendering in a UI, without forcing a particular style.
      - `text` string, required — This is the text part that composes the whole sentence within the StructuredText.
      - `for` string, nullable — The entity that the text describes. When present, it points to the entity that the text describes.
      - `url` string, uri, nullable — When present, it points to the entity that the text describes.
    - `text` string, required — The same content as found in the components, but without any styling.
  - `notifiable_attribute` 'registration_health' | 'new_registrations' | 'addresses' | 'officers' | 'alternative_names' | 'kyb_score' | 'risk_score' | 'identity_network' | 'pep' | 'ofac' | 'liens' | 'litigations' | 'bankruptcies' | 'website_analysis', 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)