---
title: "Receipt change feed: added / changed / removed per business per edition"
method: GET
path: "/v1/changes"
---

# Receipt change feed: added / changed / removed per business per edition

`GET /v1/changes`

## Request

- Base URL: `https://api.lodestarstamp.com`
- URL: `https://api.lodestarstamp.com/v1/changes`
- Auth: one of:
  - none
  - API key in header `X-Lodestar-Key`
  - OAuth 2 (authorization code, authorization URL `https://api.lodestarstamp.com/oauth/authorize`, token URL `https://api.lodestarstamp.com/oauth/token`, scopes: `mcp:read`)
  - API key in header `PAYMENT-SIGNATURE`

The agent-facing form of watching. Built from the append-only edition archive; each event carries the receipt hashes before and after. Filter with since (YYYY-MM-DD) and domain. Paged in feed order: at most limit events per answer (1000 unless asked, never more than 10000); total counts every event that matches, and next_cursor, sent back as cursor with the same market, since and domain, reads the next page. It is null on the last page. An answer marked data_source "unavailable" could not read the feed: it is not the end, so send the same request again later. Without market, a domain whose business no feed that could be read holds, while a feed that might hold it could not be read, answers that feed's unavailable page, never the primary's empty one.

## Query parameters

- `since` string
- `domain` string
- `limit` integer
- `cursor` string
- `market` string

## Headers

- `X-Lodestar-Consumer` string

## Response `200`

One page of change events

## Other responses

- `400`: Malformed since, limit or cursor

---

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