---
title: "Getting changes between Versions"
method: GET
path: "/v1/projects/{projectId}/datasets/{name}/entities/{uuid}/diffs"
tags: ["Entity Management"]
---

# Getting changes between Versions

`GET /v1/projects/{projectId}/datasets/{name}/entities/{uuid}/diffs`

This returns the changes, or edits, between different versions of an Entity. These changes are returned as an array of arrays. Between two Entities, there is an array of objects representing how each property changed. This change object contains the old and new values, as well as the property name.

## Path parameters

- `projectId` number, required
- `name` string, required
- `uuid` string, required

## Response `200`

+ Response 200

- EntityDiffValue[]
  - EntityDiffValueItems[]
    - `new` string — The new value of this property.
    - `old` string — The old value of this property.
    - `propertyName` string — The name of the property that is changed.

## Changes

- **2025-12-20** `022694254f0d` — 1 info
  - api operation id `Getting changes between Entity Versions` removed and replaced with `getChangesBetweenEntityVersions`
- **2025-10-27** `b11b54eea487` — 1 info
  - removed the non-success response with the status `403`
- **2025-10-10** `196d7d957d94` — 1 info
  - endpoint added
- **2025-03-13** `e8c2858fd4eb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/projects/:projectId/datasets/:name/entities/:uuid/diffs/get.md)

---

[API](https://skmtc.dev/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.dev/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getodk/odk-central-api/revisions/dc3ccc706398/schema)