Skip to main content
Glama

Firmenwatch — Swiss Company Register

Firmendetails abrufen

firma_details
Read-onlyIdempotent

Liefert die öffentlichen Angaben zu einer Firma anhand der UID: Stammdaten, Registerkapital nur mit belegter Währung, Personen- und Organabdeckung ohne Namen, Revision, Registerbefunde, belegbare Registerbezüge und den jüngsten Verlauf sowie den aktuellen MWST-, FINMA- und SECO-Abgleich mit amtlicher Quelle, Stand und Grenzen. Der öffentliche KI-Zugang gibt keine Namen natürlicher Personen und keine Finanzschätzungen aus.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
uidYesUID im Format CHE-123.456.789 oder nur die neun Ziffern
mit_verlaufNoMeldungsverlauf mitliefern

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
uidNo
codeNo
sitzNo
firmaNo
zweckNo
fehlerNo
kantonNo
profilNo
statusNo
adresseNo
analyseNo
brancheNo
hinweisNo
quellenNo
verlaufNo
complianceNo
datenstandNo
rechtsformNo
geloescht_amNo
letzte_meldungNo
kapital_nominalNo
rechtsform_codeNo
kapital_waehrungNo
branchenableitungNo
kapital_einbezahltNo
retry_after_secondsNo
erstmals_eingetragenNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / adresse / properties / nicht_oeffentlich
      Added value: +{
      +  "const": true,
      +  "type": "boolean"
      +}
  2. Changed1 schema field changed
    • addedOutput schema / properties / analyse / properties / first_registration / properties / date / description
      Added value: +"SHAB publication date of the earliest evidenced new registration; not the cantonal journal date."
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "oneOf": [
      +    {
      +      "required": [
      +        "fehler"
      +      ]
      +    },
      +    {
      +      "not": {
      +        "required": [
      +          "fehler"
      +        ]
      +      },
      +      "required": [
      +        "firma",
      +        "uid",
      +        "status",
      +        "adresse",
      +        "verlauf",
      +        "profil",
      +        "datenstand",
      +        "analyse",
      +        "compliance",
      +        "quellen",
      +        "hinweis"
      +      ]
      +    }
      +  ],
      +  "properties": {
      +    "adresse": {
      +      "properties": {
      +        "hausnummer": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "ort": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "plz": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "strasse": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "strasse",
      +        "hausnummer",
      +        "plz",
      +        "ort"
      +      ],
      +      "type": "object"
      +    },
      +    "analyse": {
      +      "properties": {
      +        "basis": {
      +          "const": "register_evidence_only",
      +          "description": "Ausschliesslich Registerstammdaten und erfasste SHAB-Ereignisse; keine Finanzschaetzungen.",
      +          "type": "string"
      +        },
      +        "data_status": {
      +          "description": "Kanonischer Firmenwatch-Datenqualitaetsstatus. Ein neueres Maximaldatum ist kein Vollstaendigkeitsbeleg; fuer lueckenlose Aussagen gilt verified_through.",
      +          "properties": {
      +            "incomplete_from": {
      +              "format": "date",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "latest_available_publication": {
      +              "format": "date",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "quality": {
      +              "enum": [
      +                "current",
      +                "processing",
      +                "degraded",
      +                "unavailable"
      +              ],
      +              "type": "string"
      +            },
      +            "verified_through": {
      +              "description": "Letzter Publikationstag vor jeder bekannten offenen technischen Freigabebarriere.",
      +              "format": "date",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "latest_available_publication",
      +            "verified_through",
      +            "quality",
      +            "incomplete_from"
      +          ],
      +          "type": "object"
      +        },
      +        "event_history": {
      +          "properties": {
      +            "by_type": {
      +              "items": {
      +                "properties": {
      +                  "count": {
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "label": {
      +                    "type": "string"
      +                  },
      +                  "type": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "type",
      +                  "label",
      +                  "count"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "captured_publications": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "coverage": {
      +              "properties": {
      +                "available_from": {
      +                  "const": "2025-01-03",
      +                  "format": "date",
      +                  "type": "string"
      +                },
      +                "before_start": {
      +                  "const": "not_available",
      +                  "type": "string"
      +                },
      +                "complete_history_guaranteed": {
      +                  "const": false,
      +                  "type": "boolean"
      +                }
      +              },
      +              "required": [
      +                "available_from",
      +                "complete_history_guaranteed",
      +                "before_start"
      +              ],
      +              "type": "object"
      +            },
      +            "evaluated_events": {
      +              "maximum": 200,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "evaluated_from": {
      +              "format": "date",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "evaluated_through": {
      +              "format": "date",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "possibly_more_events": {
      +              "type": "boolean"
      +            }
      +          },
      +          "required": [
      +            "captured_publications",
      +            "evaluated_events",
      +            "evaluated_from",
      +            "evaluated_through",
      +            "possibly_more_events",
      +            "by_type",
      +            "coverage"
      +          ],
      +          "type": "object"
      +        },
      +        "first_registration": {
      +          "properties": {
      +            "date": {
      +              "format": "date",
      +              "type": "string"
      +            },
      +            "evidence_basis": {
      +              "const": "structured_shab_new_registration",
      +              "type": "string"
      +            },
      +            "publication": {
      +              "properties": {
      +                "date": {
      +                  "format": "date",
      +                  "type": "string"
      +                },
      +                "id": {
      +                  "type": "string"
      +                },
      +                "number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "state": {
      +                  "enum": [
      +                    "commonsActual",
      +                    "commonsNew"
      +                  ],
      +                  "type": "string"
      +                },
      +                "sub_rubric": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "format": "uri",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "date",
      +                "number",
      +                "sub_rubric",
      +                "state",
      +                "url"
      +              ],
      +              "type": "object"
      +            }
      +          },
      +          "required": [
      +            "date",
      +            "evidence_basis",
      +            "publication"
      +          ],
      +          "type": "object"
      +        },
      +        "industry_classification": {
      +          "properties": {
      +            "basis": {
      +              "const": "registered_purpose_text",
      +              "type": "string"
      +            },
      +            "code": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "confidence": {
      +              "maximum": 1,
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "qualification": {
      +              "enum": [
      +                "derived",
      +                "probable"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "label",
      +            "code",
      +            "confidence",
      +            "qualification",
      +            "basis"
      +          ],
      +          "type": "object"
      +        },
      +        "legal_effect": {
      +          "const": "not_an_official_register_extract",
      +          "type": "string"
      +        },
      +        "officer_overview": {
      +          "properties": {
      +            "observed_active_entries": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "observed_former_entries": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "observed_total_entries": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "scope": {
      +              "properties": {
      +                "basis": {
      +                  "const": "captured_shab_history",
      +                  "type": "string"
      +                },
      +                "basis_date": {
      +                  "format": "date",
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "basis_publication_id": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "coverage": {
      +                  "enum": [
      +                    "none",
      +                    "partial",
      +                    "complete"
      +                  ],
      +                  "type": "string"
      +                },
      +                "description": {
      +                  "type": "string"
      +                },
      +                "empty_result_means": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "observed_from": {
      +                  "format": "date",
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "observed_through": {
      +                  "format": "date",
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "official_register_url": {
      +                  "format": "uri",
      +                  "type": "string"
      +                },
      +                "result_interpretation": {
      +                  "enum": [
      +                    "observed_entries",
      +                    "no_entries",
      +                    "data_being_completed"
      +                  ],
      +                  "type": "string"
      +                },
      +                "state_updated_at": {
      +                  "format": "date-time",
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "verified_complete": {
      +                  "type": "boolean"
      +                }
      +              },
      +              "required": [
      +                "basis",
      +                "coverage",
      +                "verified_complete",
      +                "basis_publication_id",
      +                "basis_date",
      +                "observed_from",
      +                "observed_through",
      +                "state_updated_at",
      +                "result_interpretation",
      +                "description",
      +                "empty_result_means",
      +                "official_register_url"
      +              ],
      +              "type": "object"
      +            }
      +          },
      +          "required": [
      +            "observed_active_entries",
      +            "observed_former_entries",
      +            "observed_total_entries",
      +            "scope"
      +          ],
      +          "type": "object"
      +        },
      +        "register_findings": {
      +          "properties": {
      +            "classification": {
      +              "enum": [
      +                "keine",
      +                "beobachten",
      +                "erhoeht",
      +                "kritisch"
      +              ],
      +              "type": "string"
      +            },
      +            "findings": {
      +              "items": {
      +                "properties": {
      +                  "code": {
      +                    "type": "string"
      +                  },
      +                  "detail": {
      +                    "type": "string"
      +                  },
      +                  "label": {
      +                    "type": "string"
      +                  },
      +                  "since": {
      +                    "format": "date",
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "weight": {
      +                    "maximum": 100,
      +                    "minimum": 0,
      +                    "type": "integer"
      +                  }
      +                },
      +                "required": [
      +                  "code",
      +                  "label",
      +                  "weight",
      +                  "detail",
      +                  "since"
      +                ],
      +                "type": "object"
      +              },
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "limitation": {
      +              "type": "string"
      +            },
      +            "method": {
      +              "const": "transparent_rules_on_register_facts",
      +              "type": "string"
      +            },
      +            "score": {
      +              "maximum": 100,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "classification",
      +            "score",
      +            "method",
      +            "findings",
      +            "limitation"
      +          ],
      +          "type": "object"
      +        },
      +        "register_relationships": {
      +          "properties": {
      +            "companies": {
      +              "items": {
      +                "properties": {
      +                  "canton": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "evidence": {
      +                    "properties": {
      +                      "same_registered_address": {
      +                        "type": "boolean"
      +                      },
      +                      "shared_auditor_entries": {
      +                        "minimum": 0,
      +                        "type": "integer"
      +                      },
      +                      "shared_person_entries": {
      +                        "minimum": 0,
      +                        "type": "integer"
      +                      },
      +                      "shared_shareholder_entries": {
      +                        "minimum": 0,
      +                        "type": "integer"
      +                      }
      +                    },
      +                    "required": [
      +                      "same_registered_address",
      +                      "shared_person_entries",
      +                      "shared_auditor_entries",
      +                      "shared_shareholder_entries"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "profile": {
      +                    "format": "uri",
      +                    "type": "string"
      +                  },
      +                  "status": {
      +                    "type": "string"
      +                  },
      +                  "town": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "uid": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "uid",
      +                  "name",
      +                  "status",
      +                  "canton",
      +                  "town",
      +                  "profile",
      +                  "evidence"
      +                ],
      +                "type": "object"
      +              },
      +              "maxItems": 12,
      +              "type": "array"
      +            },
      +            "companies_by_evidence": {
      +              "properties": {
      +                "same_registered_address": {
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "shared_auditor_entries": {
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "shared_person_entries": {
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "shared_shareholder_entries": {
      +                  "minimum": 0,
      +                  "type": "integer"
      +                }
      +              },
      +              "required": [
      +                "same_registered_address",
      +                "shared_person_entries",
      +                "shared_auditor_entries",
      +                "shared_shareholder_entries"
      +              ],
      +              "type": "object"
      +            },
      +            "evidence_basis": {
      +              "properties": {
      +                "officer_scope_reference": {
      +                  "const": "officer_overview.scope",
      +                  "type": "string"
      +                },
      +                "person_auditor_shareholder_entries": {
      +                  "const": "captured_shab_officer_projection",
      +                  "type": "string"
      +                },
      +                "registered_address": {
      +                  "const": "imported_register_master_data",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "registered_address",
      +                "person_auditor_shareholder_entries",
      +                "officer_scope_reference"
      +              ],
      +              "type": "object"
      +            },
      +            "interpretation_limit": {
      +              "const": "A register relationship alone does not prove control, ownership or group membership.",
      +              "type": "string"
      +            },
      +            "possibly_more_companies": {
      +              "type": "boolean"
      +            },
      +            "registered_entities_at_same_address": {
      +              "minimum": 2,
      +              "type": "integer"
      +            },
      +            "returned_companies": {
      +              "maximum": 12,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "returned_companies",
      +            "possibly_more_companies",
      +            "evidence_basis",
      +            "companies_by_evidence",
      +            "companies",
      +            "interpretation_limit"
      +          ],
      +          "type": "object"
      +        },
      +        "registered_capital": {
      +          "properties": {
      +            "currency": {
      +              "pattern": "^[A-Z]{3}$",
      +              "type": "string"
      +            },
      +            "evidence_basis": {
      +              "const": "structured_shab_company_capital",
      +              "description": "Betrag und ISO-Waehrung stammen aus demselben strukturierten Zustandsblock einer amtlichen SHAB-Publikation.",
      +              "type": "string"
      +            },
      +            "nominal": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "paid": {
      +              "minimum": 0,
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "publication": {
      +              "properties": {
      +                "date": {
      +                  "format": "date",
      +                  "type": "string"
      +                },
      +                "id": {
      +                  "type": "string"
      +                },
      +                "number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "state": {
      +                  "enum": [
      +                    "commonsActual",
      +                    "commonsNew"
      +                  ],
      +                  "type": "string"
      +                },
      +                "sub_rubric": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "format": "uri",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "date",
      +                "number",
      +                "sub_rubric",
      +                "state",
      +                "url"
      +              ],
      +              "type": "object"
      +            },
      +            "verification": {
      +              "const": "currency_evidenced",
      +              "description": "Der Registerbetrag wird nur ausgegeben, wenn der zugehoerige ISO-Waehrungscode in einer erfassten SHAB-Publikation belegt ist.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "verification",
      +            "nominal",
      +            "paid",
      +            "currency",
      +            "evidence_basis",
      +            "publication"
      +          ],
      +          "type": "object"
      +        },
      +        "registered_domicile": {
      +          "properties": {
      +            "evidence_basis": {
      +              "const": "structured_shab_company_no_address",
      +              "type": "string"
      +            },
      +            "no_address": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "publication": {
      +              "properties": {
      +                "date": {
      +                  "format": "date",
      +                  "type": "string"
      +                },
      +                "id": {
      +                  "type": "string"
      +                },
      +                "number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "state": {
      +                  "enum": [
      +                    "commonsActual",
      +                    "commonsNew"
      +                  ],
      +                  "type": "string"
      +                },
      +                "sub_rubric": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "format": "uri",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "date",
      +                "number",
      +                "sub_rubric",
      +                "state",
      +                "url"
      +              ],
      +              "type": "object"
      +            },
      +            "status": {
      +              "const": "officially_marked_no_address",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "no_address",
      +            "status",
      +            "evidence_basis",
      +            "publication"
      +          ],
      +          "type": "object"
      +        },
      +        "revision": {
      +          "properties": {
      +            "basis": {
      +              "const": "structured_shab_revision",
      +              "type": "string"
      +            },
      +            "opting_out": {
      +              "type": "boolean"
      +            },
      +            "publication": {
      +              "properties": {
      +                "date": {
      +                  "format": "date",
      +                  "type": "string"
      +                },
      +                "id": {
      +                  "type": "string"
      +                },
      +                "number": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "state": {
      +                  "enum": [
      +                    "commonsActual",
      +                    "commonsNew"
      +                  ],
      +                  "type": "string"
      +                },
      +                "sub_rubric": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "format": "uri",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "date",
      +                "number",
      +                "sub_rubric",
      +                "state",
      +                "url"
      +              ],
      +              "type": "object"
      +            },
      +            "statement": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "opting_out",
      +            "statement",
      +            "basis",
      +            "publication"
      +          ],
      +          "type": "object"
      +        },
      +        "sources": {
      +          "properties": {
      +            "master_data": {
      +              "properties": {
      +                "name": {
      +                  "const": "Zefix dataset via LINDAS",
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "format": "uri",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "name",
      +                "url"
      +              ],
      +              "type": "object"
      +            },
      +            "publications": {
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "format": "uri",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "name",
      +                "url"
      +              ],
      +              "type": "object"
      +            }
      +          },
      +          "required": [
      +            "master_data",
      +            "publications"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "basis",
      +        "data_status",
      +        "officer_overview",
      +        "event_history",
      +        "sources",
      +        "legal_effect"
      +      ],
      +      "type": "object"
      +    },
      +    "branche": {
      +      "type": "string"
      +    },
      +    "branchenableitung": {
      +      "properties": {
      +        "basis": {
      +          "const": "registered_purpose_text",
      +          "type": "string"
      +        },
      +        "code": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "einordnung": {
      +          "enum": [
      +            "derived",
      +            "probable"
      +          ],
      +          "type": "string"
      +        },
      +        "konfidenz": {
      +          "maximum": 1,
      +          "minimum": 0.45,
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "code",
      +        "konfidenz",
      +        "einordnung",
      +        "basis"
      +      ],
      +      "type": "object"
      +    },
      +    "code": {
      +      "type": "string"
      +    },
      +    "compliance": {
      +      "properties": {
      +        "basis": {
      +          "const": "official_external_sources",
      +          "type": "string"
      +        },
      +        "finma": {
      +          "properties": {
      +            "authorisation_check": {
      +              "description": "Exakter UID-Abgleich mit der veröffentlichten FINMA-Liste. no_uid_match bedeutet nur, dass diese UID im geprüften Listenstand nicht vorkommt.",
      +              "enum": [
      +                "listed",
      +                "no_uid_match",
      +                "unavailable"
      +              ],
      +              "type": "string"
      +            },
      +            "authorisations": {
      +              "items": {
      +                "properties": {
      +                  "authorisation_type": {
      +                    "type": "string"
      +                  },
      +                  "city": {
      +                    "type": "string"
      +                  },
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "source_record_id": {
      +                    "type": "string"
      +                  },
      +                  "uid": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "required": [
      +                  "source_record_id",
      +                  "name",
      +                  "city",
      +                  "uid",
      +                  "authorisation_type"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "authorisations_source": {
      +              "oneOf": [
      +                {
      +                  "properties": {
      +                    "activated_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "checked_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "coverage_status": {
      +                      "description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden.",
      +                      "enum": [
      +                        "not_applicable",
      +                        "delta_only",
      +                        "building",
      +                        "complete"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "coverage_verified_through": {
      +                      "description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag.",
      +                      "format": "date",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "fetched_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "freshness": {
      +                      "enum": [
      +                        "fresh",
      +                        "stale_warning",
      +                        "stale_problem"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "freshness_basis": {
      +                      "enum": [
      +                        "source_last_success_at",
      +                        "record_checked_at",
      +                        "complete_coverage_last_success_at"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "freshness_problem_after_hours": {
      +                      "minimum": 1,
      +                      "type": "integer"
      +                    },
      +                    "key": {
      +                      "enum": [
      +                        "uid_vat",
      +                        "finma_authorisations",
      +                        "finma_warnings",
      +                        "seco_sanctions"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "limitation": {
      +                      "type": "string"
      +                    },
      +                    "machine_url": {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    "name": {
      +                      "type": "string"
      +                    },
      +                    "record_checked_at": {
      +                      "description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung.",
      +                      "format": "date-time",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_date": {
      +                      "format": "date",
      +                      "type": "string"
      +                    },
      +                    "source_date_basis": {
      +                      "description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at.",
      +                      "enum": [
      +                        "uid_delta_window_end",
      +                        "http_last_modified",
      +                        "latest_entry_publication_date",
      +                        "official_list_issue_date"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "source_version": {
      +                      "type": "string"
      +                    },
      +                    "url": {
      +                      "format": "uri",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "key",
      +                    "name",
      +                    "url",
      +                    "machine_url",
      +                    "source_date",
      +                    "checked_at",
      +                    "source_date_basis",
      +                    "coverage_status",
      +                    "coverage_verified_through",
      +                    "record_checked_at",
      +                    "freshness_basis",
      +                    "fetched_at",
      +                    "activated_at",
      +                    "source_version",
      +                    "freshness",
      +                    "freshness_problem_after_hours",
      +                    "limitation"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "authorisations_total": {
      +              "description": "Exakte Zahl der UID-Treffer vor der begrenzten Ausgabe.",
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "authorisations_truncated": {
      +              "type": "boolean"
      +            },
      +            "warning_check": {
      +              "description": "Konservativer Abgleich von exaktem Firmennamen und Ort. Ein Ergebnis ist weder Identitäts- noch Unbedenklichkeitsnachweis.",
      +              "enum": [
      +                "possible_match",
      +                "no_exact_name_location_match",
      +                "unavailable"
      +              ],
      +              "type": "string"
      +            },
      +            "warning_matches": {
      +              "items": {
      +                "properties": {
      +                  "identity": {
      +                    "enum": [
      +                      "confirmed_by_register_reference",
      +                      "candidate_requires_review"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "match_basis": {
      +                    "enum": [
      +                      "exact_register_reference",
      +                      "exact_name_and_location"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "name": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "official_url": {
      +                    "format": "uri",
      +                    "type": "string"
      +                  },
      +                  "seat": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "source_record_id": {
      +                    "type": "string"
      +                  },
      +                  "title": {
      +                    "type": "string"
      +                  },
      +                  "warning_date": {
      +                    "format": "date",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "source_record_id",
      +                  "title",
      +                  "name",
      +                  "seat",
      +                  "warning_date",
      +                  "official_url",
      +                  "match_basis",
      +                  "identity"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "warning_matches_total": {
      +              "description": "Exakte Zahl der Namens-/Ortstreffer vor der begrenzten Ausgabe.",
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "warning_matches_truncated": {
      +              "type": "boolean"
      +            },
      +            "warnings_source": {
      +              "oneOf": [
      +                {
      +                  "properties": {
      +                    "activated_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "checked_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "coverage_status": {
      +                      "description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden.",
      +                      "enum": [
      +                        "not_applicable",
      +                        "delta_only",
      +                        "building",
      +                        "complete"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "coverage_verified_through": {
      +                      "description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag.",
      +                      "format": "date",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "fetched_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "freshness": {
      +                      "enum": [
      +                        "fresh",
      +                        "stale_warning",
      +                        "stale_problem"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "freshness_basis": {
      +                      "enum": [
      +                        "source_last_success_at",
      +                        "record_checked_at",
      +                        "complete_coverage_last_success_at"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "freshness_problem_after_hours": {
      +                      "minimum": 1,
      +                      "type": "integer"
      +                    },
      +                    "key": {
      +                      "enum": [
      +                        "uid_vat",
      +                        "finma_authorisations",
      +                        "finma_warnings",
      +                        "seco_sanctions"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "limitation": {
      +                      "type": "string"
      +                    },
      +                    "machine_url": {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    "name": {
      +                      "type": "string"
      +                    },
      +                    "record_checked_at": {
      +                      "description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung.",
      +                      "format": "date-time",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_date": {
      +                      "format": "date",
      +                      "type": "string"
      +                    },
      +                    "source_date_basis": {
      +                      "description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at.",
      +                      "enum": [
      +                        "uid_delta_window_end",
      +                        "http_last_modified",
      +                        "latest_entry_publication_date",
      +                        "official_list_issue_date"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "source_version": {
      +                      "type": "string"
      +                    },
      +                    "url": {
      +                      "format": "uri",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "key",
      +                    "name",
      +                    "url",
      +                    "machine_url",
      +                    "source_date",
      +                    "checked_at",
      +                    "source_date_basis",
      +                    "coverage_status",
      +                    "coverage_verified_through",
      +                    "record_checked_at",
      +                    "freshness_basis",
      +                    "fetched_at",
      +                    "activated_at",
      +                    "source_version",
      +                    "freshness",
      +                    "freshness_problem_after_hours",
      +                    "limitation"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            }
      +          },
      +          "required": [
      +            "authorisation_check",
      +            "authorisations_total",
      +            "authorisations_truncated",
      +            "authorisations",
      +            "warning_check",
      +            "warning_matches_total",
      +            "warning_matches_truncated",
      +            "warning_matches",
      +            "authorisations_source",
      +            "warnings_source"
      +          ],
      +          "type": "object"
      +        },
      +        "legal_effect": {
      +          "const": "screening_aid_not_official_confirmation",
      +          "type": "string"
      +        },
      +        "seco": {
      +          "properties": {
      +            "candidates": {
      +              "items": {
      +                "properties": {
      +                  "address": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "country_code": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "identity": {
      +                    "const": "candidate_requires_review",
      +                    "type": "string"
      +                  },
      +                  "listing_effective_date": {
      +                    "description": "Wirksamkeitsdatum der juengsten amtlichen listed-Modifikation; bleibt null, wenn die Quelle kein solches Datum nennt.",
      +                    "format": "date",
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "listing_effective_date_basis": {
      +                    "const": "latest_official_listed_modification_effective_date",
      +                    "type": "string"
      +                  },
      +                  "machine_evidence_url": {
      +                    "description": "Fuer den Abgleich verwendete amtliche XML-Gesamtliste; fuer Maschinen, nicht als leichter Einzellink.",
      +                    "format": "uri",
      +                    "type": "string"
      +                  },
      +                  "match_basis": {
      +                    "enum": [
      +                      "exact_legal_name",
      +                      "exact_legal_name_and_location",
      +                      "exact_official_alias"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "matched_name": {
      +                    "type": "string"
      +                  },
      +                  "matched_name_kind": {
      +                    "enum": [
      +                      "primary_name",
      +                      "official_alias",
      +                      "former_name",
      +                      "spelling_variant"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "official_search_url": {
      +                    "description": "Menschenlesbare offizielle SECO-Suche; die SSID steht in source_record_id.",
      +                    "format": "uri",
      +                    "type": "string"
      +                  },
      +                  "program": {
      +                    "type": "string"
      +                  },
      +                  "source_record_id": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "source_record_id",
      +                  "name",
      +                  "matched_name",
      +                  "matched_name_kind",
      +                  "program",
      +                  "listing_effective_date",
      +                  "listing_effective_date_basis",
      +                  "country_code",
      +                  "official_search_url",
      +                  "machine_evidence_url",
      +                  "address",
      +                  "match_basis",
      +                  "identity"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "candidates_total": {
      +              "description": "Exakte Zahl der amtlich belegten Namenstreffer vor der begrenzten Ausgabe.",
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "candidates_truncated": {
      +              "type": "boolean"
      +            },
      +            "direct_match_check": {
      +              "description": "Exakter Abgleich mit direkt gelisteten amtlichen Haupt- und Alternativnamen; Eigentums- und Kontrollbeziehungen sind nicht abschliessend erfasst.",
      +              "enum": [
      +                "possible_match",
      +                "no_exact_match",
      +                "unavailable"
      +              ],
      +              "type": "string"
      +            },
      +            "source": {
      +              "oneOf": [
      +                {
      +                  "properties": {
      +                    "activated_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "checked_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "coverage_status": {
      +                      "description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden.",
      +                      "enum": [
      +                        "not_applicable",
      +                        "delta_only",
      +                        "building",
      +                        "complete"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "coverage_verified_through": {
      +                      "description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag.",
      +                      "format": "date",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "fetched_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "freshness": {
      +                      "enum": [
      +                        "fresh",
      +                        "stale_warning",
      +                        "stale_problem"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "freshness_basis": {
      +                      "enum": [
      +                        "source_last_success_at",
      +                        "record_checked_at",
      +                        "complete_coverage_last_success_at"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "freshness_problem_after_hours": {
      +                      "minimum": 1,
      +                      "type": "integer"
      +                    },
      +                    "key": {
      +                      "enum": [
      +                        "uid_vat",
      +                        "finma_authorisations",
      +                        "finma_warnings",
      +                        "seco_sanctions"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "limitation": {
      +                      "type": "string"
      +                    },
      +                    "machine_url": {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    "name": {
      +                      "type": "string"
      +                    },
      +                    "record_checked_at": {
      +                      "description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung.",
      +                      "format": "date-time",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_date": {
      +                      "format": "date",
      +                      "type": "string"
      +                    },
      +                    "source_date_basis": {
      +                      "description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at.",
      +                      "enum": [
      +                        "uid_delta_window_end",
      +                        "http_last_modified",
      +                        "latest_entry_publication_date",
      +                        "official_list_issue_date"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "source_version": {
      +                      "type": "string"
      +                    },
      +                    "url": {
      +                      "format": "uri",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "key",
      +                    "name",
      +                    "url",
      +                    "machine_url",
      +                    "source_date",
      +                    "checked_at",
      +                    "source_date_basis",
      +                    "coverage_status",
      +                    "coverage_verified_through",
      +                    "record_checked_at",
      +                    "freshness_basis",
      +                    "fetched_at",
      +                    "activated_at",
      +                    "source_version",
      +                    "freshness",
      +                    "freshness_problem_after_hours",
      +                    "limitation"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            }
      +          },
      +          "required": [
      +            "direct_match_check",
      +            "candidates_total",
      +            "candidates_truncated",
      +            "candidates",
      +            "source"
      +          ],
      +          "type": "object"
      +        },
      +        "sources": {
      +          "items": {
      +            "properties": {
      +              "activated_at": {
      +                "format": "date-time",
      +                "type": "string"
      +              },
      +              "checked_at": {
      +                "format": "date-time",
      +                "type": "string"
      +              },
      +              "coverage_status": {
      +                "description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden.",
      +                "enum": [
      +                  "not_applicable",
      +                  "delta_only",
      +                  "building",
      +                  "complete"
      +                ],
      +                "type": "string"
      +              },
      +              "coverage_verified_through": {
      +                "description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag.",
      +                "format": "date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "fetched_at": {
      +                "format": "date-time",
      +                "type": "string"
      +              },
      +              "freshness": {
      +                "enum": [
      +                  "fresh",
      +                  "stale_warning",
      +                  "stale_problem"
      +                ],
      +                "type": "string"
      +              },
      +              "freshness_basis": {
      +                "enum": [
      +                  "source_last_success_at",
      +                  "record_checked_at",
      +                  "complete_coverage_last_success_at"
      +                ],
      +                "type": "string"
      +              },
      +              "freshness_problem_after_hours": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "key": {
      +                "enum": [
      +                  "uid_vat",
      +                  "finma_authorisations",
      +                  "finma_warnings",
      +                  "seco_sanctions"
      +                ],
      +                "type": "string"
      +              },
      +              "limitation": {
      +                "type": "string"
      +              },
      +              "machine_url": {
      +                "format": "uri",
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": "string"
      +              },
      +              "record_checked_at": {
      +                "description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung.",
      +                "format": "date-time",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "source_date": {
      +                "format": "date",
      +                "type": "string"
      +              },
      +              "source_date_basis": {
      +                "description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at.",
      +                "enum": [
      +                  "uid_delta_window_end",
      +                  "http_last_modified",
      +                  "latest_entry_publication_date",
      +                  "official_list_issue_date"
      +                ],
      +                "type": "string"
      +              },
      +              "source_version": {
      +                "type": "string"
      +              },
      +              "url": {
      +                "format": "uri",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "key",
      +              "name",
      +              "url",
      +              "machine_url",
      +              "source_date",
      +              "checked_at",
      +              "source_date_basis",
      +              "coverage_status",
      +              "coverage_verified_through",
      +              "record_checked_at",
      +              "freshness_basis",
      +              "fetched_at",
      +              "activated_at",
      +              "source_version",
      +              "freshness",
      +              "freshness_problem_after_hours",
      +              "limitation"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "vat": {
      +          "properties": {
      +            "end_date": {
      +              "format": "date",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "entry_date": {
      +              "format": "date",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "source": {
      +              "oneOf": [
      +                {
      +                  "properties": {
      +                    "activated_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "checked_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "coverage_status": {
      +                      "description": "complete darf nur mit amtlichem Vollbestand und lueckenlosem Folgefeed gesetzt werden.",
      +                      "enum": [
      +                        "not_applicable",
      +                        "delta_only",
      +                        "building",
      +                        "complete"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "coverage_verified_through": {
      +                      "description": "Nur bei coverage_status=complete: letzter lueckenlos belegter Quelltag.",
      +                      "format": "date",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "fetched_at": {
      +                      "format": "date-time",
      +                      "type": "string"
      +                    },
      +                    "freshness": {
      +                      "enum": [
      +                        "fresh",
      +                        "stale_warning",
      +                        "stale_problem"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "freshness_basis": {
      +                      "enum": [
      +                        "source_last_success_at",
      +                        "record_checked_at",
      +                        "complete_coverage_last_success_at"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "freshness_problem_after_hours": {
      +                      "minimum": 1,
      +                      "type": "integer"
      +                    },
      +                    "key": {
      +                      "enum": [
      +                        "uid_vat",
      +                        "finma_authorisations",
      +                        "finma_warnings",
      +                        "seco_sanctions"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "limitation": {
      +                      "type": "string"
      +                    },
      +                    "machine_url": {
      +                      "format": "uri",
      +                      "type": "string"
      +                    },
      +                    "name": {
      +                      "type": "string"
      +                    },
      +                    "record_checked_at": {
      +                      "description": "Letzter direkter Beleg der konkreten UID-Zeile; getrennt von der globalen Feed-Abdeckung.",
      +                      "format": "date-time",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source_date": {
      +                      "format": "date",
      +                      "type": "string"
      +                    },
      +                    "source_date_basis": {
      +                      "description": "Maschinenlesbare Bedeutung von source_date; das Abrufdatum steht separat in fetched_at beziehungsweise checked_at.",
      +                      "enum": [
      +                        "uid_delta_window_end",
      +                        "http_last_modified",
      +                        "latest_entry_publication_date",
      +                        "official_list_issue_date"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "source_version": {
      +                      "type": "string"
      +                    },
      +                    "url": {
      +                      "format": "uri",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "key",
      +                    "name",
      +                    "url",
      +                    "machine_url",
      +                    "source_date",
      +                    "checked_at",
      +                    "source_date_basis",
      +                    "coverage_status",
      +                    "coverage_verified_through",
      +                    "record_checked_at",
      +                    "freshness_basis",
      +                    "fetched_at",
      +                    "activated_at",
      +                    "source_version",
      +                    "freshness",
      +                    "freshness_problem_after_hours",
      +                    "limitation"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "source_checked_at": {
      +              "format": "date-time",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "status": {
      +              "description": "Amtlicher MWST-Status der konkreten UID. unknown und unavailable sind ausdrücklich keine Negativaussage.",
      +              "enum": [
      +                "active",
      +                "registered",
      +                "ended",
      +                "not_registered",
      +                "unknown",
      +                "unavailable"
      +              ],
      +              "type": "string"
      +            },
      +            "uid_vat": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "status",
      +            "uid_vat",
      +            "entry_date",
      +            "end_date",
      +            "source_checked_at",
      +            "source"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "basis",
      +        "vat",
      +        "finma",
      +        "seco",
      +        "sources",
      +        "legal_effect"
      +      ],
      +      "type": "object"
      +    },
      +    "datenstand": {
      +      "format": "date",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "erstmals_eingetragen": {
      +      "format": "date",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "fehler": {
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "firma": {
      +      "type": "string"
      +    },
      +    "geloescht_am": {
      +      "format": "date",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "hinweis": {
      +      "type": "string"
      +    },
      +    "kanton": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "kapital_einbezahlt": {
      +      "minimum": 0,
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "kapital_nominal": {
      +      "minimum": 0,
      +      "type": "number"
      +    },
      +    "kapital_waehrung": {
      +      "pattern": "^[A-Z]{3}$",
      +      "type": "string"
      +    },
      +    "letzte_meldung": {
      +      "format": "date",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "profil": {
      +      "format": "uri",
      +      "type": "string"
      +    },
      +    "quellen": {
      +      "properties": {
      +        "aktualisierungen": {
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "format": "uri",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "url"
      +          ],
      +          "type": "object"
      +        },
      +        "stammdaten": {
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "format": "uri",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "url"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "stammdaten",
      +        "aktualisierungen"
      +      ],
      +      "type": "object"
      +    },
      +    "rechtsform": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "rechtsform_code": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "retry_after_seconds": {
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    "sitz": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "status": {
      +      "enum": [
      +        "active",
      +        "in_liquidation",
      +        "bankrupt",
      +        "deleted"
      +      ],
      +      "type": "string"
      +    },
      +    "uid": {
      +      "type": "string"
      +    },
      +    "verlauf": {
      +      "items": {
      +        "properties": {
      +          "amtlicher_beleg": {
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          "art": {
      +            "type": "string"
      +          },
      +          "art_code": {
      +            "enum": [
      +              "new_registration",
      +              "name_change",
      +              "address_change",
      +              "seat_change",
      +              "purpose_change",
      +              "capital_change",
      +              "legal_form_change",
      +              "officer_added",
      +              "officer_removed",
      +              "auditor_change",
      +              "liquidation_opened",
      +              "liquidation_closed",
      +              "deletion",
      +              "bankruptcy_opened",
      +              "bankruptcy_suspended",
      +              "bankruptcy_closed",
      +              "moratorium",
      +              "debt_enforcement",
      +              "branch_opened",
      +              "branch_closed",
      +              "merger",
      +              "other"
      +            ],
      +            "type": "string"
      +          },
      +          "beschreibung": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "datum": {
      +            "format": "date",
      +            "type": "string"
      +          },
      +          "ereignis_id": {
      +            "type": "string"
      +          },
      +          "publikations_id": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ereignis_id",
      +          "publikations_id",
      +          "datum",
      +          "art",
      +          "art_code",
      +          "beschreibung",
      +          "amtlicher_beleg"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "zweck": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • addedInput schema / additionalProperties
      Added value: +false
  5. First observed

TDQS

A4.2/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish read-only, idempotent, open-world behavior, so the description correctly focuses on additional constraints beyond those hints. It explicitly discloses that natural-person names and financial estimates are not provided ('gibt keine Namen natürlicher Personen und keine Finanzschätzungen aus') and notes boundaries like 'nur mit belegter Währung' and 'ohne Namen'. This gives the agent actionable expectations about response content and limitations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description front-loads the core purpose in the first clause and then uses a dense comma-separated list to convey scope. It is longer than a typical description, but every listed element adds information about what the tool does or does not return. The structure is somewhat run-on, yet remains readable and contains no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With a rich output schema, detailed annotations, and an informative description, an agent has enough to select and invoke the tool correctly. The description covers content categories, data limitations (no person names, no financial estimates), and currentness aspects (MWST-, FINMA- and SECO-Abgleich with Stand), which are critical context not derivable from schema alone.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already fully explains both parameters, including the UID format and mit_verlauf default. The description adds minor contextual information by mentioning 'jüngsten Verlauf' as an output component and referencing UID as the lookup key, but it does not materially expand param semantics beyond a baseline. Baseline 3 is appropriate given full schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with an explicit verb and resource: 'Liefert die öffentlichen Angaben zu einer Firma anhand der UID'. It then enumerates the delivered categories (Stammdaten, Registerkapital, Personen- und Organabdeckung, etc.), making the tool's scope clear. Although it does not name sibling tools directly, the combination of 'anhand der UID' and the detail inventory distinguishes it sufficiently from firma_suchen and uid_pruefen.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies the intended use: retrieve public company details by UID. It clearly communicates that the tool expects a UID and returns public information, which is a basic usage context. However, it does not explicitly mention when not to use it or point to alternatives such as firma_suchen or uid_pruefen, so routing guidance is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources