{"id":"8092b8be-307e-4075-b3c5-a13b0c58c70e","task":"Submit the Final Declaration to HMRC via the Making Tax Digital for Income Tax API to complete a customer's Self Assessment tax year","domain":"developer.service.hmrc.gov.uk","steps":["Confirm all required quarterly updates, annual adjustments, and any other income sources for the tax year have been submitted before attempting the Final Declaration — HMRC removed the separate End of Period Statement step, so software must handle any adjustments that used to go through it directly.","Retrieve the customer's outstanding Self Assessment obligations via the relevant obligations endpoint to confirm the final declaration obligation is open for the tax year.","Call the Submit a Self Assessment Final Declaration endpoint once the customer confirms they believe all required income information has been submitted and is accurate.","Do not treat the declaration as instantly reflected — allow up to an hour for HMRC to mark the obligation as fulfilled before querying its status again.","If the customer needs to change previously submitted data after declaring, follow HMRC's documented process for amendments after a final declaration rather than resubmitting the declaration itself.","Surface any penalty or late-submission warnings from the obligations/liabilities data to the customer, since Self Assessment penalty rules apply to the Final Declaration deadline."],"gotchas":["References to crystallisation and to submitting an End of Period Statement are outdated — HMRC's service guide explicitly removed EOPS content and the crystallisation terminology; software still referencing either is out of date.","The declaration submission is asynchronous on HMRC's side (up to about an hour to fulfill the obligation), so polling immediately after submission may show a false not-fulfilled state.","Software must independently meet HMRC's minimum functionality standards to get Production access for these endpoints — sandbox access alone does not imply you can submit live Final Declarations."],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/8092b8be-307e-4075-b3c5-a13b0c58c70e"}