Skip to main content

HMRC API Changelog

HMRC rebuilt its losses API in June. Software still on the old version will fail when you send losses for 2026-27.

· Updated · 9 min read · Checked against HMRC's published API changelog and developer newsletter on 6 November 2026

A changelog few landlords read, with real consequences

We run a small monitor that watches HMRC's Making Tax Digital API specifications for the APIs our live app calls. In early July it flagged that a whole new version of the API that records tax losses, 7.0, had appeared; HMRC's changelog showed it had gone live in Production on 16 June. The version our first integration was built on had, months earlier, been quietly fenced off from the current tax year.

This is the first in an occasional series where we write those changes down. Not because a landlord should have to care about API versions, but because the gap between “HMRC recognised” and “actually keeping up” is hard to see from the outside, and this is a clean example of the difference that could cost you a rejected submission.

What changed, in one paragraph

HMRC released version 7.0 of its Individual Losses (MTD) API to production on 16 June 2026, for tax years 2026-27 onwards. It replaces the two separate resources in version 6.0, brought forward losses and loss claims, with a single group named Losses and Claims and three endpoints: retrieve, create or amend, and delete. Version 6.0 has not been switched off; since 22 January 2026 it simply refuses any tax year after 2025-26. HMRC's developer newsletter of 30 September 2026 says it is scheduled for deprecation on 1 February 2028, with retirement planned for 1 August 2028.

Put plainly: 6.0 is last year's API. It still accepts tax years up to 2025-26. For a 2026-27 return, HMRC says to use 7.0, which has a field for brought forward losses applied in that year. HMRC's documents do not say whether a 2025-26 loss sent through 6.0 reaches the 2026-27 calculation, so check that it appears. So when a landlord comes to send losses for 2026-27, from 6 April 2027, their software has to be speaking 7.0, or the request is rejected before it reaches a human.

Why this matters if you have a property loss

Property losses happen. A year of heavy repairs or a long void can leave your whole property business with allowable expenses and any capital allowances above its rent. All the UK lettings you run outside a partnership count as one business, so one loss-making property creates no loss if the others cover it. Mortgage interest on residential lettings does not count, because it gets a separate basic-rate tax reducer instead, and the capital cost of buying a property does not count either. A loss is carried forward against the next profits of the same business, which lowers the tax you pay then.

Under Making Tax Digital, brought forward losses and loss claims are sent through this API. If your software tries to send 2026-27 loss figures using version 6.0, HMRC answers with RULE_TAX_YEAR_FOR_VERSION_NOT_SUPPORTED and does nothing else. There is no partial credit and no silent fallback. What that costs depends on the loss. HMRC's documents give this endpoint as the software route for a brought forward loss, and we found nothing saying the calculation picks one up another way. Check your calculation before you finalise. If the loss is missing, you could pay more tax than you owe, until it is sent through software that supports version 7.0 and your return is amended (normally by 31 January 2029; after that, any remedy is narrower). A loss made in 2026-27 usually matters when it is set against a later year's profit. The exception is the part of the loss that comes from capital allowances (other than structures and buildings allowance) or from agricultural estate expenses. That part can be claimed against your other income for 2026-27 or 2027-28, up to a cap of £50,000 or, if more, 25% of your adjusted total income. If that claim cannot be sent, your 2026-27 bill could be higher than it needs to be. A rejected submission does not itself remove the relief, but the claim has its own deadline: one year after the 31 January filing date for the year you set it against (31 January 2029 for 2026-27, 31 January 2030 for 2027-28). Overpayment relief does not cover a claim that was never made, so after that date the relief is lost.

So this is not a plumbing detail. It can be the difference between a brought forward loss that reduces your 2026-27 bill and one that does not show up in your calculation because the software was a version behind.

The timeline, dated

Every entry below is from HMRC's published changelog, last checked on 6 November 2026.

Losses v4.0 and v5.0 retired

9 January 2026

Removed from both Sandbox and Production, alongside about twenty other API versions. Any integration never updated past them stopped working entirely.

v6.0 capped at 2025-26

22 January 2026

A new error, RULE_TAX_YEAR_FOR_VERSION_NOT_SUPPORTED, restricts version 6.0 to tax years up to 2025-26. This is the change that quietly sets a deadline for any software that files 2026-27 losses.

v7.0 arrives in Sandbox

23 March 2026

Three new endpoints under one name, Losses and Claims, for tax years 2026-27 onwards. Available to test, not yet to file against.

v7.0 goes to Production

16 June 2026

The new version went live for real filings. Because HMRC only accepts losses once the tax year has ended, losses for 2026-27 can first be sent from 6 April 2027. On software still on 6.0, that is when the first failure a landlord is likely to see comes.

The pattern is worth noticing. The version cap landed in January, just under five months before the replacement reached production in June. For anyone reading the changelog, that was just under five months of warning. For a landlord whose software firm was not reading it, the first sign is likely to be a rejected submission from 6 April 2027.

What actually changed in the shape of it

We built our first losses integration against version 6.0, so we can be specific about the size of the change. In 6.0, brought forward losses and loss claims are two separate things, with their own paths and their own operations. Our 6.0 code carried eleven distinct calls to cover them: create, list, retrieve, amend and delete a brought forward loss, and create, list, retrieve, change the type of, delete and reorder a loss claim. Only the five brought forward calls are wired into our app. We tested the six claim endpoints in HMRC's test environment, and no screen uses them.

Version 7.0 folds all of that into one resource, Losses and Claims, with three endpoints: retrieve them, create or amend them, and delete them. Eleven calls become three. That HMRC gave the new group a single combined name, where 6.0 had two, is the clearest signal of the merge; we read the collapse from the naming and the endpoint list, since the two old resources no longer appear separately for 2026-27.

One more detail the changelog carried, for the engineers: 7.0 added an optional header in Sandbox, suspend-temporal-validations, that lets you submit an in-year loss while testing. Without it, an in-year submission returns RULE_TAX_YEAR_NOT_ENDED. It is a testing convenience, marked Sandbox only, and it tells you HMRC still expects losses to settle at year end, not mid-year.

How would you even know?

You probably would not, unless you asked your vendor. We found no announcement aimed at taxpayers; HMRC published it for software firms, in its developer changelog and newsletter. A landlord has little reason to read either, and may not know their software is a version behind until a submission is rejected.

This is the quiet problem with the phrase “HMRC recognised”. We found nothing in HMRC's published guidance that removes a product from its software finder for being late to a new API version. HMRC does publish dates: it says 2026-27 returns should use version 7.0, and it plans to retire 6.0 on 1 August 2028. The losses cap was published in January; the replacement went live in June. A listed product that stopped paying attention in between could still be listed and still fail when it sends losses for 2026-27.

We run the monitor to catch these changes for our own integration. It only watches API specifications, so it did not pick up version 6.0's retirement date, and an earlier version of this post wrongly said no date had been set. We now check HMRC's developer newsletter as well when we re-check this post. LetSort is not HMRC recognised and is not on its software list, so none of this is a reason to prefer it to a listed product. The one question worth asking any Making Tax Digital vendor is narrow and revealing: which versions of the HMRC APIs do you support for 2026-27, and how quickly do you move when they change?

One more thing in the changelog

On 15 June 2026 HMRC added a Retrieve ITSA Penalties endpoint to version 4.0 of the Self Assessment Accounts (MTD) API in Sandbox, and on 15 September 2026 it reached Production. Software can now read a taxpayer's MTD penalty points and penalties directly. For 2026-27 HMRC has said there are no penalties for late quarterly updates, but you still have to send them before you can submit your tax return, and the new late return and late payment penalties apply from the year you join.

Common questions

Did HMRC’s Making Tax Digital losses API really change in 2026?

Yes. HMRC released version 7.0 of the Individual Losses (MTD) API to production on 16 June 2026. It consolidates the two separate resources in version 6.0, brought forward losses and loss claims, into a single set of three endpoints for tax years 2026-27 onwards. Version 6.0 still serves the tax years up to 2025-26.

Will my software still work if it uses the old losses API version?

Only for older tax years. Since 22 January 2026, version 6.0 rejects any tax year after 2025-26 with the error RULE_TAX_YEAR_FOR_VERSION_NOT_SUPPORTED. To send property loss figures for 2026-27 the software must call version 7.0. HMRC only accepts losses after the tax year ends, so on software that has not been updated, the first failure a landlord is likely to see comes from 6 April 2027, when losses for 2026-27 can first be sent.

What is a brought forward loss for a landlord?

A property loss from an earlier year, carried forward to reduce the tax on a later year’s property profit. A year when allowable expenses and any capital allowances across your whole property business exceed your rent can produce one. Under Making Tax Digital you send it through HMRC’s losses API, which from 2026-27 means version 7.0’s Create or Amend Losses and Claims endpoint. HMRC describes the brought forward route as being for losses from before you joined MTD; carry-forward amounts go to the same endpoint, though in law a property loss carries forward without a claim.

Has HMRC retired the old losses API version?

Not yet. Version 6.0 still works for tax years up to 2025-26. HMRC’s developer newsletter of 30 September 2026 says it is scheduled for deprecation on 1 February 2028, with retirement planned for 1 August 2028. Versions 4.0 and 5.0 were retired on 9 January 2026, so any integration never updated past those has already stopped working entirely.

How would I know if my software is behind on HMRC’s API?

From the outside, you usually would not. HMRC publishes these changes for software firms, in its developer changelog and newsletter, not for taxpayers. The fair question to ask a vendor is which API versions they support for 2026-27.

Sources

This series is built on HMRC's own dated changelog and developer newsletter. We re-read the changelog, the newsletters, the Individual Losses documentation, the penalties guidance, the Property Income Manual page and the legislation below on 6 November 2026.

Related

Written by Ben Morton, founder of LetSort. We built LetSort's first losses integration against version 6.0 of HMRC's Individual Losses API and added version 7.0 for 2026-27 onwards in October 2026. Version 6.0 is still used for brought forward losses up to 2025-26. As at 6 November 2026 neither has been used for a live filing, and version 7.0 has only run in HMRC's test environment. We run a monitor that flags changes to the HMRC API specifications for the APIs our live app calls, alongside reading HMRC's developer changelog and newsletter. The dates and version numbers above come from those sources, last checked on 6 November 2026. LetSort is operated by ToggleKit Ltd.