organisations

Get a VAT registration

Allows retrieval of name and address of a VAT registered company

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

Request

Base URL
https://api.service.hmrc.gov.uk
Auth
OAuth 2
Client credentials
Token URLhttps://api.service.hmrc.gov.uk/oauth/token
TypeScript
https://skmtc.dev/hmrc/apis/vat-registered-companies-api/docs/organisations/vat/check-vat-number/lookup/:targetVrn/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

targetVrnstring required

Example:123456789

UK VAT registration number you wish to check. <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

processingDatestring required

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.