VatNumberVerificationDto
The outcome of verifying a client's VAT number against HMRC's Check a UK VAT Number service.
When the number is registered, HMRC's registered name and address are returned so the user can
compare them with the client record — a mismatch is information, not an error.
Properties
| Name | Type | Description |
|---|---|---|
| registered | boolean | Whether HMRC recognises the number as a current VAT registration. |
Whether HMRC recognises the number as a current VAT registration. | ||
| vatNumber | string | The VAT number that was checked, as normalised by HMRC (no GB prefix, no spaces). |
The VAT number that was checked, as normalised by HMRC (no GB prefix, no spaces). | ||
| hmrcName | string | The name HMRC holds the registration under. Null when not registered. |
The name HMRC holds the registration under. Null when not registered. | ||
| hmrcAddressLine1 | string | First line of the registered address. Null when not registered. |
First line of the registered address. Null when not registered. | ||
| hmrcPostcode | string | Postcode of the registered address. Null when not registered or held abroad. |
Postcode of the registered address. Null when not registered or held abroad. | ||
| hmrcCountryCode | string | ISO country code of the registered address. Null when not registered. |
ISO country code of the registered address. Null when not registered. | ||
| consultationNumber | string | HMRC's consultation number — proof the check was made, for the AML file. Present only when |
HMRC's consultation number — proof the check was made, for the AML file. Present only when | ||
| verifiedDate | string | When the verification was recorded. Null when the number was not registered. |
When the verification was recorded. Null when the number was not registered. | ||
JSON Example
{
"registered": false,
"vatNumber": "string",
"hmrcName": "string",
"hmrcAddressLine1": "string",
"hmrcPostcode": "string"
}