---
title: "Get project metadata change history"
method: GET
path: "/editor/history/{id}"
tags: ["Projects"]
---

# Get project metadata change history

`GET /editor/history/{id}`

Paginated audit log of metadata changes for a project (study metadata saves and JSON patch operations). Each entry may include a v1 change record with `version`, `scope`, `summary`, and `patch` (list of path-level add/remove/replace operations with old/new values).

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

successful operation

- ProjectHistoryResponse
  - `status` string
  - `history` AuditLogHistoryEntry[]
    - `id` integer
    - `obj_type` string
    - `obj_id` integer
    - `user_id` integer
    - `action_type` string — Audit action (e.g. update, patch)
    - `created` string, date-time
    - `obj_ref_id` integer, nullable
    - `metadata` union — Change record or other audit payload
      - MetadataChangeRecordV1 — Metadata change payload stored in audit log entries for saves that produced a diff. When diff computation fails, `status` is `diff_failed` and `before`/`after` contain normalized snapshots.
        - `version` integer
        - `scope` 'study_metadata' | 'admin_metadata' | 'template'
        - `summary` MetadataChangeSummary
          - `added` integer
          - `removed` integer
          - `replaced` integer
        - `patch` MetadataChangePatchItem[]
          - `op` 'add' | 'remove' | 'replace'
          - `path` string — JSON Pointer path (RFC 6901)
          - `old` unknown
          - `new` unknown
        - `status` 'diff_failed'
        - `error` string
        - `before` object
        - `after` object
      - object
    - `username` string, nullable
    - `email` string, nullable
  - `limit` integer
  - `offset` integer
  - `total` integer — Total matching entries
  - `found` integer — Number of entries returned in this page

## Other responses

- `400` — Bad request

---

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