---
title: "List changes"
method: GET
path: "/segmentation/changes/list"
tags: ["Segmentation - Changes"]
---

# List changes

`GET /segmentation/changes/list`

List all segment changes

## Query parameters

- `segmentUuid` string, uuid, required — Segment identifier.
- `hasRecords` 'added' | 'updated' | 'removed' — Filter changes by record kind.
- `limit` string — Maximum number of changes to return.
- `offset` string — Number of changes to skip.

## Response `200`

Successful response

- object
  - `changes` object[], required — List of changes.
    - `uuid` string, required
    - `workspaceUuid` string, required
    - `segmentUuid` string, required
    - `slug` string, required
    - `totalRecordsCount` number, required
    - `updatedRecordsCount` number, required
    - `removedRecordsCount` number, required
    - `addedRecordsCount` number, required
    - `unchangedRecordsCount` number, required
    - `createdAt` string, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

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