This version is in beta - expect some breaking changes.

VAT (MTD) API

Dates and amounts
Date Amount
Version and status
Available in Sandbox Yes
Sandbox base URL https://test-api.service.hmrc.gov.uk
Available in Production Yes
Production base URL https://api.service.hmrc.gov.uk

Overview

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.

Errors

Testing

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

Versioning

Endpoints

The way we show VAT (MTD) API v1.0 endpoints has changed, which might look different to other Developer Hub APIs.

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