# info.description
Task-sized contract for tax-expert coverage and bounded deterministic assessments. Deterministic, effective-dated tax decisions and reviewed public maps, with primary sources and explicit review boundaries. TaxSorted-authored documentation, summaries and curation use CC BY-SA 4.0; linked sources retain their own terms; the server source code uses AGPL-3.0.

# info.license.name
CC BY-SA 4.0 (API documentation and TaxSorted-authored curation)

# paths./v1/uk/tax-expert.get.summary
See what the UK tax expert can and cannot do

# paths./v1/uk/tax-expert.get.description
Public coverage registry. Stages distinguish mapped, explained, classified, calculated, prepared and filed capability.

# paths./v1/uk/tax-expert.get.responses.200.description
Current UK tax-expert coverage and boundaries.

# paths./v1/uk/tax-expert.get.responses.500.description
Unexpected public-service failure with a non-sensitive request ID and recovery action.

# paths./v1/uk/tax-expert/mtd-income-tax/assessments.post.summary
Assess MTD Income Tax readiness and 2026/27 deadlines

# paths./v1/uk/tax-expert/mtd-income-tax/assessments.post.description
Stateless classification from explicit Self Assessment, gross-income and exemption facts, the trusted server evaluation date and the admitted ruleset and source ledger. Unknown is never read as zero. The route does not sign up, file or persist case facts.

# paths./v1/uk/tax-expert/mtd-income-tax/assessments.post.responses.200.description
A determined result or an explicit missing-fact, HMRC-decision, source-review or professional-review path.

# paths./v1/uk/tax-expert/mtd-income-tax/assessments.post.responses.400.description
Malformed JSON or duplicate object fields.

# paths./v1/uk/tax-expert/mtd-income-tax/assessments.post.responses.401.description
Missing, malformed, expired or revoked workspace key.

# paths./v1/uk/tax-expert/mtd-income-tax/assessments.post.responses.403.description
The workspace key lacks tax-expert:assess.

# paths./v1/uk/tax-expert/mtd-income-tax/assessments.post.responses.422.description
The JSON facts do not match the strict request schema.

# paths./v1/uk/tax-expert/mtd-income-tax/assessments.post.responses.500.description
Unexpected server error; request facts are not echoed.

# tags[].description
Stateless machine orientation and the plain-text doorway.

# tags[].description
Evidence-backed tax capability discovery and bounded deterministic assessments.

# x-taxsorted-slice.availableSlices[].title
TaxSorted UK Observer Accountability API

# components.securitySchemes.WorkspaceKey.description
A TaxSorted workspace key. Tax calculations and assessments declare their required scope, such as sdlt:calculate or tax-expert:assess.