A client's employment income for a tax year under MTD Income Tax: the employments themselves, the financial details held against each, and the income belonging to no single employment (non-PAYE tips, share schemes, lump sums, deductions). Employments come from two places and what can be done to them differs: one HMRC hold from the employer's RTI submissions cannot be edited or deleted, only ignored, while a custom employment added here can be amended and deleted but never ignored.

Save Other Employment Income

PUT /tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/income/other

Sends the year's share schemes, lump sums and employment deductions to HMRC. A full replacement — every entry that should survive must be in the request, so editing one means sending them all back. Clearing the year is a delete rather than an empty save.

Parameters

Name	Type	Description
tenant*	path string	The Tenant.Code
The Tenant.Code
client*	path string
taxYear*	path string

Request Body*

SaveMtdOtherEmploymentIncomeRequest

{
  "shareOption": [
    {
      "employerName": "...",
      "employerRef": "...",
      "schemePlanType": "...",
      "dateOfOptionGrant": "...",
      "dateOfEvent": "..."
    }
  ],
  "sharesAwardedOrReceived": [
    {
      "employerName": "...",
      "employerRef": "...",
      "schemePlanType": "...",
      "dateSharesCeasedToBeSubjectToPlan": "...",
      "noOfShareSecuritiesAwarded": "..."
    }
  ],
  "disability": {
    "customerReference": "string",
    "amountDeducted": 0
  },
  "foreignService": {
    "customerReference": "string",
    "amountDeducted": 0
  },
  "lumpSums": [
    {
      "employerName": "...",
      "employerRef": "...",
      "taxableLumpSumsAndCertainIncome": "...",
      "benefitFromEmployerFinancedRetirementScheme": "...",
      "redundancyCompensationPaymentsOverExemption": "..."
    }
  ]
}

Responses

200 OK

MtdSubmissionReceiptDto

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found