API Docs / Schemas / MtdHeldPositionDto

MtdHeldPositionDto

The cumulative position HMRC currently holds for one income source and tax year — whichever
software filed it. Nothing held is the normal state before the year's first submission, not
an error.

Properties

Name Type Description
isHeldboolean

Whether HMRC holds any figures for the year.

Whether HMRC holds any figures for the year.

heldToDatestring

The period end HMRC's held figures run to, when anything is held.

The period end HMRC's held figures run to, when anything is held.

selfEmploymentFiguresSelfEmploymentCumulativeSummary
ukPropertyFiguresUkPropertyCumulativeSummary
foreignPropertyFiguresForeignPropertyCumulativeSummary

JSON Example

{
  "isHeld": false,
  "heldToDate": "2024-01-01",
  "selfEmploymentFigures": {
    "periodDates": "...",
    "periodIncome": "...",
    "periodExpenses": "...",
    "periodDisallowableExpenses": "..."
  },
  "ukPropertyFigures": {
    "fromDate": "2024-01-01",
    "toDate": "2024-01-01",
    "submittedOn": "2024-01-01T00:00:00Z",
    "ukProperty": "..."
  },
  "foreignPropertyFigures": {
    "fromDate": "2024-01-01",
    "toDate": "2024-01-01",
    "submittedOn": "2024-01-01T00:00:00Z",
    "foreignProperty": [
      "..."
    ]
  }
}

Used By Operations