Save Residential Disposals

PUT /tenants/{tenant}/clients/{client}/mtd/capital-gains/{taxYear}/residential

Sends the year's UK residential property disposals to HMRC — a full replacement of the list, so every disposal that should survive must be present. A request with no disposals is refused: clearing the year is a delete rather than an empty save. Reporting here does not discharge the in-year payment-on-account return.

Parameters

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

Request Body*

SaveMtdCgtResidentialDisposalsRequest

{
  "disposals": [
    {
      "numberOfDisposals": "...",
      "customerReference": "...",
      "disposalDate": "...",
      "completionDate": "...",
      "disposalProceeds": "..."
    }
  ]
}

Responses

200 OK

MtdSubmissionReceiptDto

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found