Documentation / Checks

VIES availability

akwito probes the VIES check-status endpoint every five minutes from its own servers and records one bucket per member state. The measurements are published, with no API key and no session: GET /vies-status renders them as a page, GET /vies-status.json returns the same figures as JSON. Both answer Cache-Control: public, max-age=60 and sit behind the same per-IP limiter as the public verification routes (30 per minute, bursting to 60).

json

{
  "measured_at": "2026-09-17T10:05:00Z",
  "bucket_minutes": 5,
  "countries": [
    {
      "code": "DE",
      "name": "Allemagne",
      "current": "unavailable",
      "availability_24h": 98.6,
      "availability_7d": 91.2,
      "availability_30d": 84.0,
      "link": "open"
    }
  ],
  "calls_30d": { "ok": 1234, "ko": 56 }
}

Field	Meaning
`measured_at`	When the figures were read, RFC 3339 in UTC
`bucket_minutes`	Width of one probe bucket, always 5
`code`	Member state code as VIES spells it (`EL` for Greece)
`name`	French name of the member state
`current`	`available`, `unavailable`, or `unknown` when no probe landed in the last 15 minutes
`availability_24h`, `availability_7d`, `availability_30d`	Probe success rate over the window, one decimal, or `null` when no sample exists
`link`	State of the akwito circuit breaker towards that member state: `closed`, `half_open`, `open`, or `""` when we have never called it
`calls_30d`	Our own real calls over 30 days, all member states together

Only member states are listed. A country with no probe bucket in the last 30 days is absent from countries, and the VIES global flag is never reported as a country.