Moloni ON Logo WhiteGuidesAPI ReferenceExplorer
API Reference

ViesCheckStatus

enum

Outcome of a VIES check.

VIES only answers whether a VAT number is valid for intra-community transactions — it never reports why a number is not valid. So NOT_VALID covers both a number that does not exist and a number that exists nationally but is not registered for intra-community trade; the two are indistinguishable in the response, and the modern VIES REST API offers no extra detail either. Every other value means VIES gave us no answer about the number at all.

Values

Fields

NameDescription
VALIDThe member state confirmed the number as valid for intra-community transactions.
NOT_VALIDThe member state did not confirm the number (VIES valid = false).
INVALID_INPUTVIES rejected the country code / VAT number we sent (INVALID_INPUT).
SERVICE_UNAVAILABLEVIES itself is down or throttling us (SERVICE_UNAVAILABLE, SERVER_BUSY, GLOBAL_MAX_CONCURRENT_REQ*).
MEMBER_STATE_UNAVAILABLEThe member state's VAT database is down, timed out or throttling us (MS_UNAVAILABLE, TIMEOUT, MS_MAX_CONCURRENT_REQ*).
UNKNOWN_ERRORVIES gave no usable answer: blocked VAT number or IP, unparseable response, network failure.

© 2026 Moloni ON

Tax Authority Certificate No. 3075