Identitaet

Minimalen Identitaetskern per UID aufloesen

Schluesselfreier Root-Resolver ausserhalb von /api/v1. Liefert UID, aktuellen Namen, Registerstatus, Rechtsform, registrierten Sitz und Zeitstaende. Strassenadresse, Zweck, Kapital, Branche, Organe und Ereignisse sind bewusst nicht enthalten. Die Fassung folgt dem dauerhaft versionierten JSON Schema Firmenidentitaet CH 1.0.

get/uid/{uid}.json

Request

  • Base URL: https://firmenwatch.ch
  • URL: https://firmenwatch.ch/uid/{uid}.json
  • Auth: none required

Path parameters

uidstring required

Kanonisch formatierte UID; andere Schreibweisen werden bewusst nicht aufgeloest.

Response

Aktueller minimaler Identitaetskern der Rechtseinheit. Die Antwort ist no-store; auch bedingte Abrufe erhalten deshalb den vollständigen 200-Vertrag statt einer 304-Antwort.

schema_version'1.0' required

Formatversion. Additive Felder sind kompatibel; Entfernen, Umbenennen oder Umdeuten verlangt eine neue Hauptversion.

idstring uri required

Namensunabhaengige, dauerhafte URI der Rechtseinheit.

uidstring required

Kanonisch formatierte Schweizer Unternehmens-Identifikationsnummer.

namestring required

Aktuell uebernommener Firmenname.

register_status'active' | 'in_liquidation' | 'bankrupt' | 'deleted' required

Aktuell uebernommener Registerstatus.

first_registered_atstring date nullable required

Datum der ersten bekannten Eintragung, sofern vorhanden.

last_event_atstring date nullable required

Datum der juengsten bei Firmenwatch bekannten amtlichen Aktualisierung.

record_updated_atstring date-time required

Technischer Verarbeitungszeitpunkt dieses Datensatzes bei Firmenwatch; kein amtlicher Eintragungs- oder Publikationszeitpunkt.

profile_urlstring uri required

Aktuelles menschenlesbares Firmenprofil.

resolver_urlstring uri required

Diese maschinenlesbare Darstellung.

Example response

{
  "schema_version": "1.0",
  "id": "https://firmenwatch.ch/uid/CHE-116.281.710",
  "uid": "CHE-116.281.710",
  "name": "Muster Handels AG",
  "register_status": "active",
  "legal_form": {
    "code": "0106",
    "label": "Aktiengesellschaft"
  },
  "registered_seat": {
    "municipality": "Zuerich",
    "canton": "ZH"
  },
  "first_registered_at": "2019-03-14",
  "last_event_at": "2026-08-25",
  "record_updated_at": "2026-08-25T08:30:00.000Z",
  "profile_url": "https://firmenwatch.ch/firma/muster-handels-ag-che-116281710",
  "resolver_url": "https://firmenwatch.ch/uid/CHE-116.281.710.json",
  "data_status": {
    "latest_available_publication": "2026-08-25",
    "verified_through": "2026-08-25",
    "quality": "current",
    "incomplete_from": null,
    "health_url": "https://firmenwatch.ch/api/v1/health"
  },
  "source": {
    "master_data": {
      "name": "Zefix",
      "delivery": "LINDAS",
      "url": "https://lindas.admin.ch/foj/zefix"
    },
    "updates": {
      "name": "Schweizerisches Handelsamtsblatt (SHAB)",
      "role": "Aktualisierungsbasis",
      "url": "https://www.shab.ch"
    },
    "methodology_url": "https://firmenwatch.ch/datenquellen"
  }
}

Changes

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