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
VALID

The member state confirmed the number as valid for intra-community transactions.

NOT_VALID

The member state did not confirm the number (VIES valid = false).

INVALID_INPUT

VIES rejected the country code / VAT number we sent (INVALID_INPUT).

SERVICE_UNAVAILABLE

VIES itself is down or throttling us (SERVICE_UNAVAILABLE, SERVER_BUSY, GLOBAL_MAX_CONCURRENT_REQ*).

MEMBER_STATE_UNAVAILABLE

The member state's VAT database is down, timed out or throttling us (MS_UNAVAILABLE, TIMEOUT, MS_MAX_CONCURRENT_REQ*).

UNKNOWN_ERROR

VIES gave no usable answer: blocked VAT number or IP, unparseable response, network failure.

© 2026 Moloni ON

Tax Authority Certificate No. 3075