Swiss UID register VAT registration state for a canonical UID

Returns what the Swiss UID register record BUMIT holds says about this canonical UID's VAT registration. result is VAT_ACTIVE, VAT_INACTIVE, NO_VAT_REGISTRATION or UNKNOWN.

Linkage (VAT_VERIFY): exact canonical UID equality only. No legal name, address, city, punctuation-heuristic, similarity-score, fuzzy or LLM matching exists anywhere in this path, and a VAT status is never constructed from a company UID alone.

The UID register may associate an entity with a VAT UID that differs from its company UID, including branch and VAT-group structures. BUMIT retains both identifiers independently as source facts, reports any canonical form separately as a normalized value, and never constructs a VAT status from a company UID alone.

Separate questions, never merged: UID assignment and structural validity, the source entity status, and the VAT registration state. A structurally valid or assigned UID does not mean the company is active or VAT registered; an inactive or deleted company does not make its UID invalid; an inactive VAT registration does not mean the company is inactive. VAT_ACTIVE is not safe-to-transact and not sanctions clearance.

The normalized VAT result comes from an explicitly versioned mapping of source status values. A source status the mapping does not list — including an unknown or future value — yields UNKNOWN and is never silently mapped to active or inactive. The source value itself is always reported verbatim alongside the normalized result.

Absence of evidence is never evidence of absence. NO_VAT_REGISTRATION requires the source to explicitly state that no registration exists. A missing record, silent VAT block, malformed payload, stale dataset, unavailable source or contradictory evidence is UNKNOWN.

Provenance separates BUMIT's retrieved_at from source-published dates: the VAT entry date and the VAT end or liquidation date are source fields and are never treated as retrieval times.

Live retrieval is not implemented: there is no SOAP request path, no scheduler and no polling. This deployment serves synthetic fixture datasets, marked evidence_class: SYNTHETIC_FIXTURE.

get/api/v1/company/{uid}/vat

Request

  • Base URL: https://bumit.ai
  • URL: https://bumit.ai/api/v1/company/{uid}/vat
  • Auth: none required

Path parameters

uidstring required
Example:CHE-123.456.789

Swiss UID in canonical or compact form, e.g. CHE-123.456.789.

Response

VAT verification result with the source VAT identifier and status verbatim, source dates, normalized result, coverage, matching ruleset, claims, freshness, provenance and attribution.

Changes

No recorded changes to this operation across all 1 revision of this API.