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

# History Activity

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

## Request

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

Histogram of translation_history changes over time, split by change_source
AND by surface (task 1697 Inc B + zoom + variant-history). The `period` preset
is a ZOOM level; custom from/to auto-buckets; source + surface are filterable.

## Path parameters

- `project_id` string, required

## Query parameters

- `period` string, nullable: zoom preset: 24h→day/30 bars, 7d→week/16 bars, 1m→month/12 bars, 15d→day/15 bars (or use from/to). Also day|week|month aliases.
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `bucket` string, nullable: hour|day|week|month override
- `languages` string, nullable
- `namespaces` string, nullable
- `source` string, nullable
- `surface` string, nullable: csv surface filter (default|desktop|mobile|tablet|aria_label|alt_text|screen_reader|plain_language); 'default' = base

## Response `200`

Successful Response

- ActivityOut
  - `bucket_unit` string, required
  - `total` integer, required
  - `buckets` ActivityBucket[], required
    - `start` string, date-time, required
    - `count` integer, required
    - `by_source` object, required
    - `by_surface` object, required

## 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)