API Docs / Operations / Client - MTD Tax Return / Review Tax Return

Review Tax Return

GET /tenants/{tenant}/clients/{client}/mtd/tax-return/{taxYear}

Everything that has to be right before a client's tax return is sent: every income source's obligations, reporting setup, held position, year-end submission and adjustable summaries; all their other income; losses; liability adjustments where the year has them; HMRC's calculation; and the declaration with whatever is standing in the way. This is thirty or more HMRC requests behind one call, so it is slow the first time a year is opened and fast afterwards. Pass refresh=true to ask HMRC again rather than reuse cached answers — only ever from an explicit action by the user. Anything named in unavailableParts could not be read from HMRC; it never means HMRC hold nothing.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

client* path string
refresh query boolean
taxYear* path string

Responses

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