API reference · v1

List timeline events

Published milestones and detected changes. Pagination stays on the first page’s snapshot; check supersession fields.

GET/v1/applications/{id}/timeline

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.

Response fields

itemsarray

Array of the items described below.

Show item fields

idstring

Stable event identifier.

applicationIdstring

Application identifier.

kindstring

Milestone or change type; new values may be added.

titlestring

Human-readable event title.

datestring

Published date or observation date. Interpret with precision and evidenceType.

precision"day" | "month" | "year"

Published date precision. Do not interpret a month or year value as an exact day.

rawDatestring · optional

Original date text Omitted when not collected.

observedAtstring

UTC time PlanningTrack observed this event; separate from its published date.

evidenceType"published_milestone" | "published_deadline" | "detected_change"

published_milestone: council event date; published_deadline: council deadline; detected_change: time a change was observed.

sourceUrlstring

Absolute source URL. Council links may change or require a browser session.

sourceFieldstring · optional

Original source field Omitted when not collected.

snapshotIdstring

Immutable snapshot identifier.

supersedesEventIdstring · optional

Earlier event replaced by this one Omitted when not collected.

supersededByEventIdstring · optional

Later replacement event Omitted when not collected.

documentIdstring · optional

Related document identifier Omitted when not collected.

withdrawnAtstring · optional

UTC time this event stopped being supported by the source. Omitted while current.

nextCursorstring | null

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

snapshotIdstring

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.