Skip to main content

VatResolveResponse

Response returned by the VAT resolve endpoint.

vatIdstringrequired

VAT identifier that was resolved.

statusResolveStatusrequired

Final outcome of the VAT resolve request.

Possible values: [Valid, Invalid, Unavailable]

flagsVatResolveFlag[]nullable

Optional flags that add context to the resolve result.

Possible values: [VatSyntaxInvalid, Obfuscated]

resolvedData objectnullable

Normalized company and address data returned by the resolve lookup, when available.

companyNamestringnullable

Normalized company name returned by the VAT resolve lookup.

streetstringnullable

Normalized street returned by the VAT resolve lookup.

citystringnullable

Normalized city returned by the VAT resolve lookup.

zipstringnullable

Normalized postal code returned by the VAT resolve lookup.

rawAddressstringnullable

Unparsed address string returned when the upstream source did not provide structured address fields. If structured address data is available, this field is not returned.

checkedAtdate-timerequired

Timestamp when the VAT ID was checked.

included objectnullable

Additional requested fields keyed by include value.

property name*stringnullable
VatResolveResponse
{
"vatId": "string",
"status": "Valid",
"flags": [
"VatSyntaxInvalid"
],
"resolvedData": {
"companyName": "string",
"street": "string",
"city": "string",
"zip": "string",
"rawAddress": "string"
},
"checkedAt": "2024-07-29T15:51:28.071Z",
"included": {}
}