VIES Error

TIMEOUT

Member state didn't respond in time

What does TIMEOUT mean?

The TIMEOUT error means VIES sent a request to a member state's VAT database, but the response didn't arrive within the allowed time limit. The national system is reachable but responding too slowly.

This is different from MS_UNAVAILABLE. The country's system isn't completely down, it's just not responding fast enough. This often happens when national systems are under heavy load.

When does this error occur?

  • During high-traffic periods when national systems are slow
  • When a member state's database is performing slowly
  • During partial outages where systems are degraded but not offline
  • More common for countries with older or less robust infrastructure

Why is this a problem?

TIMEOUT errors are frustrating because they waste time. Your request went through the entire validation flow, only to fail at the last step. And since the national system might have processed the request, retrying could create duplicate work.

Timeouts suggest degraded performance

Unlike hard failures, TIMEOUT errors indicate the system is struggling. Multiple timeouts for a country suggest their infrastructure is overloaded or experiencing problems.

How to handle TIMEOUT

1. Use a VAT validation service with faster sources

VatDB's infrastructure is optimized for performance and connects to multiple official EU and national databases. When VIES is slow, we route to faster sources. Use webhooks to receive results asynchronously without blocking your application.

2. Retry with caution

The request might have been processed. Retry, but watch for duplicate operations. A short delay of 1 to 2 seconds before retrying often helps.

3. Track timeout patterns

Monitor which countries timeout frequently and consider alternative validation approaches for them.

Fast, reliable VAT validation

VatDB connects to multiple official EU and national databases, optimized for performance. We handle timeouts internally, retry intelligently, and fall back to faster data sources when VIES is slow. Use webhooks to receive results asynchronously.

Try VatDB Free

Frequently Asked Questions

What's a good timeout value for VIES requests?
VIES recommends 30 seconds, though most successful requests complete in under 5 seconds. If you're seeing frequent timeouts, increase your client timeout to 30 to 60 seconds.
Should I retry TIMEOUT errors?
Yes, but with short delays. The system is responding slowly, not failing completely. A retry after 1 to 2 seconds often succeeds.
Which countries have the most timeout issues?
Germany (DE) is notorious for slow responses and timeouts. Italy, Spain, and Poland also experience occasional slowness during peak periods.
How does VatDB handle TIMEOUT errors?
VatDB implements intelligent timeout handling. We use adaptive timeouts based on historical response times, retry automatically, and fall back to faster national data sources when VIES is slow. You can use webhooks to receive results without waiting.
Can increasing my timeout prevent these errors?
Partially. A longer timeout lets slow responses complete instead of failing. But it also means your users wait longer. For production systems, using a service with faster data sources is better than just waiting longer.