api.invoket.com

{
  "properties": {
    "data": {
      "properties": {
        "address": {
          "type": "string"
        },
        "checked_at": {
          "description": "Timestamp of the live check against VIES - freshness is 'live', this is never a cached answer",
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "coverage": {
          "type": "string"
        },
        "derived_from_siren": {
          "type": "string"
        },
        "name": {
          "description": "Legal name relayed verbatim when the member state discloses it (status 'valid' only); absent when not disclosed ('---' in VIES), never guessed. Same for address",
          "type": "string"
        },
        "reason": {
          "type": "string"
        },
        "status": {
          "description": "'valid' or 'invalid' are firm answers from the member state - both billed, a firm no is useful. 'unverifiable' is the honest degraded answer when VIES or the member state is down: the syntax check is still served, with 'reason' (MS_UNAVAILABLE, timeout...) and coverage='syntax_only' - never a 5xx for a VIES outage",
          "type": "string"
        },
        "syntax_valid": {
          "description": "Always true on a 200: a syntactically invalid number is a 400. Stated explicitly so the 'unverifiable' degraded answer stays useful - the syntax, at least, is good",
          "type": "boolean"
        },
        "vat_number": {
          "type": "string"
        }
      },
      "required": [
        "checked_at",
        "country",
        "status",
        "syntax_valid",
        "vat_number"
      ],
      "type": "object"
    },
    "provenance": {
      "properties": {
        "fetched_at": {
          "type": "string"
        },
        "freshness": {
          "properties": {
            "kind": {
              "type": "string"
            }
          },
          "required": [
            "kind"
          ],
          "type": "object"
        },
        "source": {
          "type": "string"
        }
      },
      "required": [
        "fetched_at",
        "freshness",
        "source"
      ],
      "type": "object"
    }
  },
  "required": [
    "data",
    "provenance"
  ],
  "type": "object"
}