---
title: "Get Annotation Versions"
method: GET
path: "/v1/annotations/{annotation_id}/versions"
tags: ["Annotations"]
---

# Get Annotation Versions

`GET /v1/annotations/{annotation_id}/versions`

Version history of an annotation (ADM-15).

Every value-changing edit mints a new version; each descriptor names who
made the edit, when, and which fields changed. Fetch a specific version's
full state at /versions/{version}.

## Path parameters

- `annotation_id` string, required

## Response `200`

Successful Response

- AnnotationVersionsResponse — Full version history of one annotation (ADM-15).
  - `annotation_id` string, required
  - `current_version` integer, required
  - `versions` AnnotationVersionDescriptor[]
    - `version` integer, required — Version number.
    - `current` boolean — True for the live version.
    - `edited_at` string, date-time, nullable — When this version was CREATED (the edit that produced it); None for version 1, whose creation time is the annotation's created_at.
    - `edited_by` string, nullable — Who produced this version (None for version 1).
    - `edited_by_type` string, nullable
    - `changed_fields` string[] — Fields the edit producing this version changed.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

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