API Docs / Schemas / MtdDividendsIncomeDto

MtdDividendsIncomeDto

The foreign and special dividends HMRC hold for a client and tax year: dividends from foreign
companies, dividends received whilst abroad, stock dividends, redeemable shares, bonus issues
of securities and close company loans written off.

Plain UK dividends are a separate HMRC resource — see SodiumHQ.DTOs.MtdSubmissions.MtdUkDividendsDto — and the
two are saved and cleared independently.

Properties

Name Type Description
clientCodestring

The Sodium client the values belong to, stamped by the API on the way out.

The Sodium client the values belong to, stamped by the API on the way out.

taxYearstring

The tax year, in HMRC's format, e.g. 2025-26.

The tax year, in HMRC's format, e.g. 2025-26.

isHeldboolean

Whether HMRC hold anything for this resource and tax year.

Whether HMRC hold anything for this resource and tax year.

lastActionMtdSubmissionStampDto
dividendsDividendsIncome

JSON Example

{
  "clientCode": "string",
  "taxYear": "string",
  "isHeld": false,
  "lastAction": {
    "kind": "string",
    "action": "string",
    "reference": "string",
    "taxYear": "string",
    "performedByUserCode": "string"
  },
  "dividends": {
    "submittedOn": "2024-01-01T00:00:00Z",
    "foreignDividend": [
      "..."
    ],
    "dividendIncomeReceivedWhilstAbroad": [
      "..."
    ],
    "stockDividend": "...",
    "redeemableShares": "..."
  }
}

Contained in Schemas