Track legislation.gov.uk publications
uklaw_track_changesRead-onlyIdempotent
Read the legislation.gov.uk Publication Log for a date window of up to 31 days: new items, new revised versions, newly recorded effects, and withdrawals, newest first — the compliance-monitoring view of "what changed". Filter by content type, effect direction, category, an item or type/year, first-time items only, or event. With a full item path it reads that item's own log, usually in one call; otherwise it walks the window day by day, newest first, so a broad window may need several calls. A changes event carries no effect detail — uklaw_get_amendments with that item has it. Continue with next_cursor.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | A full item path (ukpga/2018/12) or legislation.gov.uk URI reads that item's own log; a type (uksi) or type and year (uksi/2026) narrows the day walk. Get a full path from uklaw_lookup_citation or uklaw_search_legislation. | |
| event | No | Only published or only withdrawn events. Omit for both. | |
| limit | No | Most events returned by this call (1–80). | |
| cursor | No | next_cursor from the previous call, passed with the other inputs unchanged; omit to start from end_date. | |
| category | No | Item category: primary, secondary, or eu-origin. With content_type legislation or associated-documents only. | |
| end_date | No | Last event date, YYYY-MM-DD; defaults to start_date. The window is at most 31 days. | |
| new_only | No | true: only events for items appearing on legislation.gov.uk for the first time. | |
| direction | No | With content_type changes only: effects recorded against (affected) or made by (affecting) the item. | |
| start_date | Yes | First event date of the window, YYYY-MM-DD (UK local time). | |
| content_type | No | legislation (documents published), changes (effects recorded), draft, or associated-documents. Omit for all. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied. | |
| days | No | Days touched by a day walk (empty in item-log mode). | |
| mode | No | day_walk: per-day pages; item_log: one item's undated log. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Events returned. | |
| events | No | Events, newest first. | |
| notice | No | Guidance when the window is quiet or the list continues. | |
| window | No | The window read. | |
| filters | No | Filters applied. | |
| has_more | No | True when more events remain in the window — call again with next_cursor. | |
| truncated | No | True when the list was capped at limit. | |
| attribution | No | Attribution lines the returned content requires (OGL always; EU and Westlaw credits when applicable). | |
| next_cursor | No | Pass as cursor to continue; present only when has_more is true. | |
| read_back_to | No | Item-log mode: date (YYYY-MM-DD) of the oldest event this call read from the item's log, which is read newest first. While it is after end_date, the read has not reached the window yet. Absent in a day walk and when no event read carries a calendar date. | |
| item_log_total | No | Events in the item's whole log, all dates; present in item-log mode when reported. |