API Docs / Operations / Client - MTD Capital Gains / Save Other Capital Gains

Save Other Capital Gains

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

Sends the year's capital gains other than UK residential property to HMRC. This is a full replacement — every disposal that should survive must be in the request, so editing one means sending them all back; dropping the others deletes them. Clearing the year is a delete rather than an empty save.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

client* path string
taxYear* path string
{
  "cryptoassets": [
    {
      "numberOfDisposals": "...",
      "assetDescription": "...",
      "tokenName": "...",
      "acquisitionDate": "...",
      "disposalDate": "..."
    }
  ],
  "otherGains": [
    {
      "assetType": "...",
      "numberOfDisposals": "...",
      "assetDescription": "...",
      "companyName": "...",
      "companyRegistrationNumber": "..."
    }
  ],
  "unlistedShares": [
    {
      "numberOfDisposals": "...",
      "assetDescription": "...",
      "companyName": "...",
      "companyRegistrationNumber": "...",
      "acquisitionDate": "..."
    }
  ],
  "gainsFromExcludedIndexedSecurities": 0,
  "qualifyingAssetHoldingCompany": {
    "gainsFromQahcBeforeLosses": 0,
    "lossesFromQahc": 0
  }
}

Responses

400 Bad Request
401 Unauthorized – Invalid or missing API key
404 Not Found