MtdObligationPeriodDto

A single obligation period and its deadline.

Properties

Name	Type	Description
periodStartDate	string	Start of the period being reported on.
Start of the period being reported on.
periodEndDate	string	End of the period being reported on.
End of the period being reported on.
dueDate	string	When the submission for this period is due.
When the submission for this period is due.
isFulfilled	boolean	Whether HMRC still expects a submission for this period.
Whether HMRC still expects a submission for this period.
receivedDate	string	When HMRC received the submission, once fulfilled.
When HMRC received the submission, once fulfilled.
taxYear	string	The tax year this period is filed against, in HMRC's format. Worked out by the MTD service rather than left to a caller, because the rule is not obvious and both plausible answers look right: a quarterly period belongs to the year its start date falls in from 1 April — a calendar-quarter election starts the year five days before the tax year proper — while a tax return period uses the ordinary 6 April boundary.
The tax year this period is filed against, in HMRC's format. Worked out by the MTD service rather than left to a caller, because the rule is not obvious and both plausible answers look right: a quarterly period belongs to the year its start date falls in from 1 April — a calendar-quarter election starts the year five days before the tax year proper — while a tax return period uses the ordinary 6 April boundary.

JSON Example

{
  "periodStartDate": "2024-01-01",
  "periodEndDate": "2024-01-01",
  "dueDate": "2024-01-01",
  "isFulfilled": false,
  "receivedDate": "2024-01-01"
}

Contained in Schemas

MtdIncomeSourceDto One income source for a tax year, with its deadlines.
MtdIncomeSourcesDto A client's MTD income sources with every deadline HMRC expects of them, and their tax return deadlin...