Get Losses

GET /tenants/{tenant}/clients/{client}/mtd/losses/{taxYear}

Returns the losses and loss claims HMRC hold for the tax year, in whichever of their two shapes that year uses — isRecordBased says which. Empty lists mean HMRC hold none, which is an answer rather than a failure. From 2026-27 the year is one document per income source, so businessId is required to read anything.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

client* path string
businessId query string
taxYear* path string

Responses

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