API Docs / Operations / Client - MTD Losses / Create Brought Forward Loss

Create Brought Forward Loss

POST /tenants/{tenant}/clients/{client}/mtd/losses/brought-forward/{taxYear}

Records a loss carried forward from a year before Making Tax Digital and returns HMRC's identifier for it. Tax years to 2025-26 only. Not safe to repeat: a second call either creates a duplicate loss or is refused as one. The year the loss arose in must have ended, and the claim types available later depend on the type of loss chosen here.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

client* path string
taxYear* path string
{
  "businessId": "string",
  "typeOfLoss": "Unknown",
  "lossAmount": 0
}

Responses

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