---
title: "Minimalen Identitaetskern per UID aufloesen"
method: GET
path: "/uid/{uid}.json"
tags: ["Identitaet"]
---

# Minimalen Identitaetskern per UID aufloesen

`GET /uid/{uid}.json`

## Request

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

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.

## Path parameters

- `uid` string, required

## Response `200`

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

- CompanyIdentity: Minimaler, von Firmenwatch gepflegter Identitaetsvertrag fuer Schweizer Rechtseinheiten. Kein amtlicher Registerauszug.
  - `schema_version` '1.0', required: Formatversion. Additive Felder sind kompatibel; Entfernen, Umbenennen oder Umdeuten verlangt eine neue Hauptversion.
  - `id` string, uri, required: Namensunabhaengige, dauerhafte URI der Rechtseinheit.
  - `uid` string, required: Kanonisch formatierte Schweizer Unternehmens-Identifikationsnummer.
  - `name` string, required: Aktuell uebernommener Firmenname.
  - `register_status` 'active' | 'in_liquidation' | 'bankrupt' | 'deleted', required: Aktuell uebernommener Registerstatus.
  - `legal_form` object, required
    - `code` string, nullable, required: Rechtsformcode nach eCH-0097, sofern vorhanden.
    - `label` string, nullable, required: Bezeichnung der Rechtsform, sofern vorhanden.
  - `registered_seat` object, required: Registrierter Sitz ohne Strassen- oder Zustelladresse.
    - `municipality` string, nullable, required
    - `canton` string, nullable, required
  - `first_registered_at` string, date, nullable, required: Datum der ersten bekannten Eintragung, sofern vorhanden.
  - `last_event_at` string, date, nullable, required: Datum der juengsten bei Firmenwatch bekannten amtlichen Aktualisierung.
  - `record_updated_at` string, date-time, required: Technischer Verarbeitungszeitpunkt dieses Datensatzes bei Firmenwatch; kein amtlicher Eintragungs- oder Publikationszeitpunkt.
  - `profile_url` string, uri, required: Aktuelles menschenlesbares Firmenprofil.
  - `resolver_url` string, uri, required: Diese maschinenlesbare Darstellung.
  - `data_status` object: Kanonischer Firmenwatch-Datenqualitaetsstatus. Fuer lueckenlose Aussagen gilt verified_through; aktuelle Details stehen unter health_url.
    - `latest_available_publication` string, date, nullable, required
    - `verified_through` string, date, nullable, required
    - `quality` 'current' | 'processing' | 'degraded' | 'unavailable', required
    - `incomplete_from` string, date, nullable, required
    - `health_url` string, uri, required
  - `source` object, required
    - `master_data` object, required
      - `name` 'Zefix', required
      - `delivery` 'LINDAS', required
      - `url` string, uri, required
    - `updates` object, required
      - `name` 'Schweizerisches Handelsamtsblatt (SHAB)', required
      - `role` 'Aktualisierungsbasis', required
      - `url` string, uri, required
    - `methodology_url` string, uri, required

## Other responses

- `404`: Keine sichtbare Rechtseinheit unter dieser exakt kanonischen UID.
- `500`: Unerwarteter Fehler beim Aufloesen der UID.
- `503`: Die vollstaendig gepruefte Firmenidentitaet wird gerade aktualisiert.

---

[API](https://skmtc.dev/firmenwatch/apis/firmenwatch-api.md) · [All operations](https://skmtc.dev/firmenwatch/apis/firmenwatch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firmenwatch/apis/firmenwatch-api/revisions/65e774135677?raw)