---
title: "List changes"
method: GET
path: "/changes"
tags: ["Tracking changes"]
---

# List changes

`GET /changes`

Whenever Orthanc receives a new DICOM instance, this event is recorded in the so-called _Changes Log_. This enables remote scripts to react to the arrival of new DICOM resources. A typical application is auto-routing, where an external script waits for a new DICOM instance to arrive into Orthanc, then forward this instance to another modality. Please note that, when resources are deleted, their corresponding change entries are also removed from the Changes Log, which helps ensuring that this log does not grow indefinitely.

## Query parameters

- `last` number
- `limit` number
- `since` number
- `to` number
- `type` string

## Response `200`

- object — The list of changes
  - `Changes` object[] — The individual changes
  - `Done` boolean — Whether the last reported change is the last of the full history.
  - `First` number — The index of the first reported change, its value-1 can be used for the `to` argument in subsequent calls to this route when browsing the changes in reverse order
  - `Last` number — The index of the last reported change, can be used for the `since` argument in subsequent calls to this route

---

[API](https://skmtc.net/uclouvain/apis/orthanc-api.md) · [All operations](https://skmtc.net/uclouvain/apis/orthanc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uclouvain/orthanc-api/revisions/dbfb49bf0bc7/schema)
