Client - MTD Dividends
A client's dividend income for a tax year under MTD Income Tax: foreign and special dividends, plain UK dividends, and the directorship information HMRC require where the client is a director of a close company. Three independent HMRC resources, each saved and cleared on its own. Data updates rather than filings with deadlines — HMRC hold the values, a save replaces them in full, and the retrieve re-shows whatever software last sent them.
-
PUT Save Dividends IncomeSends the year's foreign and special dividends to HMRC. This is a full replacement of what HMRC hold — anything omitted is cleared — so the request mu.../tenants/{tenant}/clients/{client}/mtd/dividends/{taxYear}
-
DELETE Delete Dividends IncomeClears the foreign and special dividends HMRC hold for the tax year. Who deleted them is recorded./tenants/{tenant}/clients/{client}/mtd/dividends/{taxYear}
-
PUT Save UK DividendsSends the year's plain UK dividends to HMRC — a full replacement of the pair. Omitting one of the two clears it, so send both whenever both should sta.../tenants/{tenant}/clients/{client}/mtd/dividends/{taxYear}/uk
-
DELETE Delete UK DividendsClears the plain UK dividends HMRC hold for the tax year./tenants/{tenant}/clients/{client}/mtd/dividends/{taxYear}/uk
-
GET Get Directorship DividendReturns the additional directorship and dividend information HMRC hold against one of the client's employments. HMRC require this from 2025-26 where t.../tenants/{tenant}/clients/{client}/mtd/dividends/{taxYear}/directorships/{employmentId}
-
PUT Save Directorship DividendSends the directorship and dividend information for one employment — a full replacement of what HMRC hold against it./tenants/{tenant}/clients/{client}/mtd/dividends/{taxYear}/directorships/{employmentId}
-
DELETE Delete Directorship DividendClears the directorship and dividend information HMRC hold against one employment./tenants/{tenant}/clients/{client}/mtd/dividends/{taxYear}/directorships/{employmentId}