API reference · v1

List application changes

The same resumable feed, restricted to one application.

GET/v1/applications/{id}/changes

Send a secret API key in Authorization: Bearer YOUR_API_KEY. Each successful request uses one of your 500 monthly requests.

Parameters

idpath · required

Opaque ID returned by the corresponding list endpoint. URL-encode the whole value.

limitquery · optional

Page size. 1–100, default 50.

Default: 50

Range: 1–100

cursorquery · optional

Opaque cursor from this endpoint with the same filters. Keep it unchanged; page size may change.

startquery · optional

See accepted values below.

Response fields

itemsarray

Array of the items described below.

Show item fields

idstring

Stable event ID. Deduplicate replays using this field.

applicationIdstring

Fetch this application to obtain its current state.

observedAtstring

Source observation time; may predate ingestion and is not feed order.

kind"discovered" | "source_changed" | "parser_changed" | "availability_changed" | "registry_changed"

discovered: first persisted record; source_changed: changed council evidence; parser_changed: changed interpretation; availability_changed: section completeness changed; registry_changed: source configuration changed.

fieldsarray

Array of the items described below.

snapshotIdstring

Resulting snapshot identifier.

previousSnapshotIdstring · optional

Previous snapshot identifier Omitted when not collected.

notifyEligibleboolean

Whether this event qualified for a new-source-change notification. Historical discoveries remain in this feed even when false.

nextCursorstring | null

Continue with this cursor; null when this page exhausts the current query.

checkpointstring

Value from the collected source record.

Errors

Error codes, request IDs, retry behaviour, and allowance headers apply to every endpoint. Invalid or repeated query parameters return 400; unavailable records return 404. Source failures never become successful empty results.