API Docs / Schemas / MtdIncomeSourceDto

MtdIncomeSourceDto

One income source for a tax year, with its deadlines.

Properties

Name Type Description
businessIdstring

HMRC's identifier for the income source, e.g. XAIS12345678910.

HMRC's identifier for the income source, e.g. XAIS12345678910.

typeOfBusinessstring

HMRC's income source type: self-employment, uk-property or foreign-property. Kept as HMRC's
own string rather than mapped to an enum, because a type Sodium cannot file for — a
furnished holiday letting, or whatever HMRC add next — would collapse into "unknown" and
hide a real business from the practice.

HMRC's income source type: self-employment, uk-property or foreign-property. Kept as HMRC's
own string rather than mapped to an enum, because a type Sodium cannot file for — a
furnished holiday letting, or whatever HMRC add next — would collapse into "unknown" and
hide a real business from the practice.

tradingNamestring

The trading name, where HMRC hold one.

The trading name, where HMRC hold one.

isCurrentboolean

Whether HMRC still list this source among the client's income sources. False for a source that
only appears in the obligations — a ceased trade, most often — which the practice may still
need to see, because filed figures hang off it and they are the proof the filing happened.

Whether HMRC still list this source among the client's income sources. False for a source that
only appears in the obligations — a ceased trade, most often — which the practice may still
need to see, because filed figures hang off it and they are the proof the filing happened.

periodsarray of MtdObligationPeriodDto

This source's quarterly update obligation periods, earliest deadline first, every year HMRC
returned. Filter on each period's tax year for one year's deadlines.

This source's quarterly update obligation periods, earliest deadline first, every year HMRC
returned. Filter on each period's tax year for one year's deadlines.

JSON Example

{
  "businessId": "string",
  "typeOfBusiness": "string",
  "tradingName": "string",
  "isCurrent": false,
  "periods": [
    {
      "periodStartDate": "...",
      "periodEndDate": "...",
      "dueDate": "...",
      "isFulfilled": "...",
      "receivedDate": "..."
    }
  ]
}

Contained in Schemas