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

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.

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

Query parameters

sincestring
Example:2026-08-24
domainstring
Example:oasisheating.com
limitinteger
cursorstring

next_cursor from the previous page of the same query

marketstring
Example:chicago-hvac

Market slug from /v1/markets. Without it a lookup starts on the primary market and falls through to every other market by domain or licence; with it the lookup stays on that record. Without it, a market that cannot be read is skipped while the others are asked, and a business none of them holds answers as a named market that cannot be read does (record_unavailable), not as not on the record. Unknown slugs answer 404 unknown_market with the list.

Headers

X-Lodestar-Consumerstring
Example:my-booking-agent

Optional self-declared consumer name, e.g. my-booking-agent. Never gates or changes the response. Used to count distinct integrations without a key, a cookie or an IP. Sending it adds only that string to what we store.

Response

One page of change events

Changes

No recorded changes to this operation across all 1 revision of this API.