v1

latestOpenAPI 3.0.32026-07-132620.5 KB

organisations

Get a VAT registration with a reference number

Retrieves the name and address of a UK VAT-registered business, if the business exists.

get/organisations/vat/check-vat-number/lookup/{targetVrn}/{requesterVrn}

Path parameters

targetVrnstring required

Example:123456789

UK VAT registration number you want to check. <br> A 9-digit or 12-digit number.

requesterVrnstring required

Example:123456789

Your VAT registration number. <br> A 9-digit or 12-digit number.

Headers

Accept'application/vnd.hmrc.2.0+json' required

Authorizationstring required

Example:Bearer bb7fed3fe10dd235a2ccda3d50fb

An OAuth 2.0 Bearer Token with the read:vat scope.

Response

requesterstring required

consultationNumberstring required

processingDatestring required

Example response

{
  "target": {
    "name": "Credite Sberger Donal Inc.",
    "vatNumber": "553557881",
    "address": {
      "line1": "131B Barton Hamlet",
      "postcode": "SW97 5CK",
      "countryCode": "GB"
    }
  }
}