Status Endpoint

Overview

Use this endpoint to check whether VIES and BZSt are reachable before submitting validation requests, or to monitor failover state in your production environment. No authentication is required — the endpoint is publicly readable so monitoring tools and agents can query it freely.

GET /v1/status

Returns the current availability and response-time of each upstream validation source, along with the active source and whether failover is engaged.

Authentication: Not required

Request

curl https://api.giltiq.de/v1/status

Response Schema

Field	Type	Description
sources.{name}.status	string	operational, degraded, or unavailable
sources.{name}.latency_ms	integer	Most recent response time in milliseconds
sources.{name}.last_checked	ISO 8601	Timestamp of the last probe for this source
active_source	string	The source currently serving live validation requests
failover_active	boolean	true when BZSt is unavailable and a fallback source is serving requests

Example: All Sources Operational

{
  "sources": {
    "bzst": {
      "status": "operational",
      "latency_ms": 312,
      "last_checked": "2026-03-26T10:14:00Z"
    },
    "vies": {
      "status": "operational",
      "latency_ms": 540,
      "last_checked": "2026-03-26T10:14:00Z"
    },
    "cache": {
      "status": "operational"
    }
  },
  "active_source": "bzst",
  "failover_active": false
}

Example: Failover Active

When BZSt is unavailable, Giltiq automatically falls back to VIES. failover_active is true and active_source reflects the fallback source.

{
  "sources": {
    "bzst": {
      "status": "unavailable",
      "latency_ms": null,
      "last_checked": "2026-03-26T10:14:00Z"
    },
    "vies": {
      "status": "degraded",
      "latency_ms": 8400,
      "last_checked": "2026-03-26T10:14:00Z"
    },
    "cache": {
      "status": "operational"
    }
  },
  "active_source": "vies",
  "failover_active": true
}

Status Values

Value	Meaning
operational	Source is reachable and responding within normal latency bounds
degraded	Source is reachable but response times are elevated (typically >3 s)
unavailable	Source did not respond within the timeout window

Notes

• Cache has no latency_ms or last_checked fields — it is always local and does not require a network probe.
• Source availability is probed approximately every 60 seconds in the background. The last_checked timestamp reflects the most recent completed probe, not the time of your request.
• failover_active: true means your validation requests are being fulfilled by the fallback source. Results are still valid — BZSt and VIES cover the same EU VAT registry data.
• A degraded source is still serving requests; only unavailable triggers failover.