VIES Error

SERVICE_UNAVAILABLE

VIES network or application error

What does SERVICE_UNAVAILABLE mean?

The SERVICE_UNAVAILABLE error indicates a general network or application problem with the VIES service. Unlike MS_UNAVAILABLE which targets a specific country, this error suggests broader infrastructure issues.

This can mean the VIES web service itself is having problems, there's a network issue between you and the EU servers, or the central VIES infrastructure is experiencing difficulties.

When does this error occur?

  • During VIES system maintenance or updates
  • When there are network connectivity issues to EU servers
  • During infrastructure problems at the EU's data centers
  • When the VIES API is experiencing high error rates

Why is this a problem?

SERVICE_UNAVAILABLE is an opaque error. You don't know if the issue is temporary, widespread, or specific to your connection. Without more information, it's difficult to know whether to retry, wait, or fail over to alternative systems.

Check if the issue is on your end

Before assuming VIES is down, verify your network connectivity. Firewall changes, DNS issues, or proxy problems can also cause SERVICE_UNAVAILABLE errors. Test from a different network if possible.

How to handle SERVICE_UNAVAILABLE

1. Use a service with alternative data sources

VatDB doesn't depend solely on VIES. We maintain multiple connections to official EU and national databases. When VIES is unavailable, we route requests to working systems. Use webhooks to get notified when validation completes asynchronously.

2. Verify connectivity first

Ensure your application can reach the VIES endpoints. Check for firewall changes, DNS issues, or proxy problems.

3. Implement retry with backoff

SERVICE_UNAVAILABLE errors often resolve quickly. Retry with exponential backoff, starting with 1 to 2 seconds between attempts.

Reliable VAT validation, even when VIES is down

VatDB connects to multiple official EU and national databases. When VIES returns SERVICE_UNAVAILABLE, we automatically route to working systems. Set up webhooks to receive validation results asynchronously when services recover.

Try VatDB Free

Frequently Asked Questions

What's the difference between SERVICE_UNAVAILABLE and MS_UNAVAILABLE?
SERVICE_UNAVAILABLE indicates a general VIES infrastructure or network problem. MS_UNAVAILABLE means a specific country's VAT system is offline. SERVICE_UNAVAILABLE is broader and less specific about the cause.
Could SERVICE_UNAVAILABLE be my network problem?
Yes. Check your network connectivity, firewall rules, and DNS resolution. Try reaching VIES from a different network to rule out local issues.
How long do SERVICE_UNAVAILABLE errors usually last?
It depends on the cause. Network glitches resolve in seconds. Infrastructure issues might last minutes to hours. If the error persists, check EU status announcements or switch to alternative validation sources.
How does VatDB handle SERVICE_UNAVAILABLE?
VatDB monitors VIES health continuously. When we detect SERVICE_UNAVAILABLE errors, we automatically route requests to our fallback data sources while retrying VIES in the background. You can use webhooks to receive results when validation completes.