---
title: "History Changes"
method: GET
path: "/v1/projects/{project_id}/history/changes"
tags: ["history-activity"]
---

# History Changes

`GET /v1/projects/{project_id}/history/changes`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/projects/{project_id}/history/changes`
- Auth: none declared

Time-ranged, paginated drill-down of individual changes across keys/langs
(task 1697 Inc B + variant-history). value/status carry old→new; change_source
is the read-derived origin; change_type a computed discriminant; surface tags
base (null) vs a11y/device variants — all filterable.

## Path parameters

- `project_id` string, required

## Query parameters

- `period` string, nullable
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `cursor` string, nullable: opaque changed_at cursor (ISO)
- `limit` integer
- `languages` string, nullable
- `namespaces` string, nullable
- `source` string, nullable: csv of DERIVED origin: human|agent|ai|import|revert|unknown
- `change_type` string, nullable: csv of change_type: create|value|status|both|revert|import|noop
- `surface` string, nullable: csv of surface slugs (default|desktop|mobile|tablet|aria_label|alt_text|screen_reader|plain_language); 'default' = base

## Response `200`

Successful Response

- ChangesOut
  - `items` ChangeItem[], required
    - `version` integer, required
    - `changed_at` string, date-time, required
    - `change_source` string, nullable, required
    - `key_uuid` string, required
    - `key_name` string, nullable, required
    - `namespace_slug` string, nullable, required
    - `language_uuid` string, required
    - `language_code` string, nullable, required
    - `value` object, required
    - `status` object, required
    - `surface` string, nullable
    - `surface_kind` string, nullable
    - `change_type` string, required
    - `plural_changed` boolean
    - `changed_by_uuid` string, nullable, required
    - `actor` ActorInfo, required
      - `kind` string, required
      - `name` string, nullable
      - `api_key_uuid` string, nullable
      - `session_id` string, nullable
      - `agent_type` string, nullable
      - `agent_version` string, nullable
  - `cursor_next` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sonenta/apis/sonenta-api.md) · [All operations](https://skmtc.dev/sonenta/apis/sonenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonenta/apis/sonenta-api/revisions/f853ea49fb05?raw)