API Docs / Schemas / SaveMtdAnnualSubmissionRequest

SaveMtdAnnualSubmissionRequest

Saves the year-end annual submission for one income source and tax year.

A full replacement at HMRC: everything that should survive must be present, because what is
absent is cleared. Clearing the whole submission is a delete, not an empty save — the MTD
service refuses an all-empty request rather than silently wiping the year.

Properties

Name Type Description
incomeSourceType*enum

Unknown SelfEmployment UkProperty ForeignProperty

Unknown SelfEmployment UkProperty ForeignProperty

selfEmploymentSelfEmploymentAnnualSubmission
ukPropertyUkPropertyAnnualSubmission
foreignPropertyarray of ForeignPropertyAnnualEntry

The foreign property values, one entry per let. Required when the income source is a foreign
property business, and must be absent otherwise.

The replacement is of the whole list: a let HMRC currently hold and this request omits has
its annual values removed, so the form must send every let that should stand.

The foreign property values, one entry per let. Required when the income source is a foreign
property business, and must be absent otherwise.

The replacement is of the whole list: a let HMRC currently hold and this request omits has
its annual values removed, so the form must send every let that should stand.

JSON Example

{
  "incomeSourceType": "Unknown",
  "selfEmployment": {
    "adjustments": "...",
    "allowances": "...",
    "nonFinancials": "..."
  },
  "ukProperty": {
    "submittedOn": "2024-01-01T00:00:00Z",
    "adjustments": "...",
    "allowances": "..."
  },
  "foreignProperty": [
    {
      "countryCode": "...",
      "propertyId": "...",
      "adjustments": "...",
      "allowances": "..."
    }
  ]
}

Used By Operations