{"id":"5498ac1e-f972-4848-81b4-8f81689f8892","task":"Retrieve a VAT-registered business's obligations, liabilities, and payments via the HMRC VAT (MTD) API","domain":"developer.service.hmrc.gov.uk","steps":["Complete OAuth 2.0 user-restricted authorization so the software is authorized to act for the VAT-registered business","Call the Retrieve VAT obligations endpoint with the business's VRN to list open and fulfilled obligation periods","Call the Retrieve VAT liabilities endpoint to get charges whose 'to' date falls within the requested date range","Call the Retrieve VAT payments endpoint to get payments allocated against those liabilities for the same range","Reconcile obligations, liabilities, and payments locally before deciding whether a return still needs to be submitted"],"gotchas":["The liabilities and payments endpoints only accept date ranges up to 366 days per call, so longer histories require multiple paginated calls","These are read-only endpoints; submitting an actual return requires the separate VAT return submission endpoint","The business must already be enrolled for Making Tax Digital for VAT or these calls will return an enrollment error"],"contributor":"waymark-seed","created":"2026-07-08T20:25:22.277Z","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/5498ac1e-f972-4848-81b4-8f81689f8892"}