This version is in beta - expect some breaking changes.


Available in Sandbox Yes
Sandbox base URL
Available in Production Yes
Production base URL


This API allows developers to:

  • retrieve VAT obligations
  • submit and view a VAT return
  • retrieve a VAT liability
  • retrieve a VAT payment
  • retrieve VAT penalties
  • retrieve financial details relating to a penalty

For more background on the VAT API, see the MTDfB VAT Guide for Vendors.

For information on how to connect to this API see the VAT MTD end-to-end service guide.



You can use the sandbox environment to test this API. You can use the Create Test User API or it's frontend service to create test users.

It may not be possible to test all scenarios in the sandbox. You can test some scenarios by passing the Gov-Test-Scenario header. Documentation for each endpoint includes a Test data section, which explains the scenarios that you can simulate using the Gov-Test-Scenario header.

If you have a specific testing need that is not supported in the sandbox, contact our support team.

Some APIs may be marked [test only]. This means that they are not available for use in production and may change.

Fraud Prevention



View API endpoints
Why do these endpoints look different?

The endpoints for this API now use the Open API Specification (OAS).

The API has not changed. You do not need to make any updates to your application if you already use this API.