API Docs / Operations / Client - MTD Quarterly Updates / Get HMRC Held Position

Get HMRC Held Position

GET /tenants/{tenant}/clients/{client}/mtd/quarterly-updates/held/{businessId}/{taxYear}

Returns the cumulative year-to-date position HMRC currently holds for one income source and tax year, whichever software filed it. This is how a quarter filed elsewhere becomes visible, and what a new update is seeded from so figures are edited forward rather than retyped. Nothing held is the normal state before the year's first submission, not an error.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

client* path string
businessId* path string
incomeSourceType* query enum

Unknown SelfEmployment UkProperty ForeignProperty

Unknown SelfEmployment UkProperty ForeignProperty

taxYear* path string

Responses

401 Unauthorized – Invalid or missing API key
404 Not Found