---
title: "Change feed — what each data release changed"
method: GET
path: "/v1/changes"
tags: ["Discovery"]
---

# Change feed — what each data release changed

`GET /v1/changes`

## Request

- Base URL: `https://api.greencalculus.com`
- URL: `https://api.greencalculus.com/v1/changes`
- Auth: none required

Open (no key). Data releases newest first, each with added/changed/withdrawn counts and a link to its per-release record. Derived at publish time from the same delta the reproducibility archive stores, so this feed cannot disagree with ?as_of= about a release. Records begin at the delta watershed (meta.record_begins); earlier versions remain archived and pinnable but are not summarised.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Releases, newest first, with counts

- ChangesList: Data releases, newest first. Per-release records begin at the archive's delta watershed (meta.record_begins); earlier versions are archived and pinnable via ?as_of= but not summarised.
  - `meta` object
    - `total` integer
    - `returned` integer
    - `next_cursor` string, nullable: Pass back as ?cursor= to resume. null on the last page.
    - `record_begins` string
  - `releases` object[]
    - `version` string
    - `date` string, nullable
    - `added` integer
    - `changed` integer
    - `withdrawn` integer
    - `detail` string: URL of the per-release record.

## Other responses

- `400`: Unknown parameter, bad limit, or unknown cursor — named in the error

---

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