List amendments to or by legislation
uklaw_get_amendmentsRead-onlyIdempotent
List the effects — amendments, repeals, revocations, commencements, modifications — recorded against an item (direction affected) or made by an item (direction affecting), from legislation.gov.uk's changes feeds. Filter by the other item (counterpart), by applied status (unapplied = the outstanding work on the revised text), and by provision. item may be partial (ukpga/2018 = all effects on 2018 Acts). Each effect names both sides with provision links, in-force dates, and why it is not applied. For the applied history of one provision in prose, read its annotations with uklaw_get_document.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | Yes | Item path or legislation.gov.uk URI (ukpga/2018/12), or a partial path: a type (uksi) or type and year (ukpga/2018). Get a full path from uklaw_lookup_citation or uklaw_search_legislation. A pre-1963 Act takes its calendar year (ukpga/1925/20, not ukpga/Geo5/15-16/20); its effects name the regnal path, and two sessions in one year can share a number. Drafts (ukdsi, sdsi, nidsr) are not in the changes feeds. | |
| limit | No | Effects per page, or with provision the most matches returned (1–100, default 20). | |
| cursor | No | next_cursor from the previous call, passed with the other inputs unchanged; omit for the first page. | |
| status | No | unapplied: effects not yet applied to the revised text; applied: already applied; all: both. | all |
| direction | No | affected: changes made to item. affecting: changes item makes to other legislation. | affected |
| provision | No | Keep only effects touching this provision of item (path or shorthand, e.g. section/45 or s. 45), including effects on the whole item. Needs a full item path. legislation.gov.uk cannot filter by provision, so each call scans up to 1,500 effects; continue with next_cursor. | |
| counterpart | No | Restrict to effects involving this other item (full or partial item path, without a provision, e.g. uksi/2019/419 or uksi/2026) — the amending item for direction affected, the amended item for affecting. A pre-1963 Act takes its calendar year, not its regnal path; drafts are not in the changes feeds. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied. | |
| scan | No | Coverage of this call; present only when filtering by provision. | |
| error | No | Present when the call failed. Absent on success. | |
| query | No | The query as normalized. | |
| shown | No | Effects returned. | |
| total | No | Total effects legislation.gov.uk holds for this query (before any provision filter). | |
| notice | No | Guidance when nothing matched or the list continues. | |
| effects | No | Effects on this page, most recently modified first; empty when none matched. | |
| has_more | No | True when more effects remain — 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. |