Client - MTD Annual Submissions

Year-end adjustments, allowances and non-financial declarations for a client's MTD Income Tax income sources. Unlike a quarterly update these are data updates rather than filings with deadlines: HMRC holds the authoritative values, a save replaces them in full, and the retrieve re-shows whatever software last sent them. Who sent or deleted a submission from Sodium is recorded separately, because HMRC's own retrieve never says.

OpenAPI Spec

Guides Operations Schemas

GET Get Annual Submission
Returns the year-end submission HMRC currently holds for one income source and tax year, whichever software sent it, together with who last sent or de...
/tenants/{tenant}/clients/{client}/mtd/annual-submissions/{businessId}/{taxYear}
PUT Save Annual Submission
Sends the year-end values for one income source and tax year to HMRC. This is a full replacement of what HMRC holds — anything omitted is cleared — so...
/tenants/{tenant}/clients/{client}/mtd/annual-submissions/{businessId}/{taxYear}
DELETE Delete Annual Submission
Deletes the year-end submission HMRC holds for one income source and tax year, removing the adjustments and allowances from their computation. Who del...
/tenants/{tenant}/clients/{client}/mtd/annual-submissions/{businessId}/{taxYear}