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

# Get Portfolio Item Changes

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

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

- V1DiffChangeResponse[]
  - `path` string, required — The path of the change
  - `operation` 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test', required — Enumeration of valid JSON Patch operation types.
  - `old_value` unknown, required
  - `new_value` unknown, required
  - `changed_at` string, date-time, required — The date and time the change was made

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