Planned

UK Tax API

This family is present as a platform-shape example only. It exists to prove that a domain-heavy API can still fit cleanly into the shared devtools structure.

Current status

Draft example placeholder used to validate the product-family contract. The routes are intentionally non-live.

Namespace/v1/uk-tax
Endpoint count4 documented routes

Planned capabilities

The scope below is descriptive only. No route should be treated as live until the status changes.

  • Self-employment calculations
  • VAT threshold checks
  • MTD readiness checks
  • Deadline lookups

Endpoint reference

The routes below are documented from the shared platform registry and reflect the current implemented contract for this family. Some routes may be environment-dependent, such as billing when no adapter is configured.

Calculate self-employment tax outputs.

Placeholder endpoint for self-employment tax estimation and rule checks.

POST /v1/uk-tax/self-employment/calculate
Handler statusPlaceholder

Check VAT threshold status.

Placeholder endpoint for VAT threshold assessment based on submitted figures.

GET /v1/uk-tax/vat/threshold-status
Handler statusPlaceholder

Check MTD income tax readiness.

Placeholder endpoint for Making Tax Digital readiness and eligibility checks.

GET /v1/uk-tax/mtd/income-tax/check
Handler statusPlaceholder

List relevant tax deadlines.

Placeholder endpoint for deadline and filing schedule lookups.

GET /v1/uk-tax/deadlines
Handler statusPlaceholder

Activation path

When implementation moves beyond placeholders, keep the namespace, docs page, and dashboard label aligned. Replace placeholder handlers in the corresponding API module rather than redesigning the platform surface.