---
title: "Normalized company record (Zefix)"
method: GET
path: "/api/v1/company/{uid}"
deprecated: true
---

# Normalized company record (Zefix)

`GET /api/v1/company/{uid}`

## Request

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

> **Deprecated.**

Returns the BUMIT canonical company record with provenance and freshness.

## Path parameters

- `uid` string, required

## Response `200`

Normalized company record

- CompanyResult
  - `status` 'OK', required
  - `company` Company, required
    - `uid` string, nullable
    - `ehraid` integer, nullable
    - `chid` string, nullable
    - `legal_name` string, required
    - `normalized_name` string, required
    - `translations` string[]
    - `names` object[]
      - `name` string
      - `normalized_name` string
      - `is_current` boolean
      - `sequence_nr` integer, nullable
    - `legal_form` object, nullable
      - `id` integer, nullable
      - `code` string, nullable
      - `name` string, nullable
      - `short_name` string, nullable
    - `legal_status` 'ACTIVE' | 'BEING_CANCELLED' | 'CANCELLED'
    - `seat` string, nullable
    - `canton` string, nullable
    - `address` Address
      - `street` string, nullable
      - `house_number` string, nullable
      - `address_addon` string, nullable
      - `po_box` string, nullable
      - `postcode` string, nullable
      - `city` string, nullable
      - `canton` string, nullable
      - `country` string
    - `purpose` string, nullable
    - `capital_nominal` string, nullable
    - `capital_currency` string, nullable
    - `incorporation_date` string, nullable: Not published by Zefix; always null in this phase.
    - `deletion_date` string, nullable
    - `last_sogc_date` string, nullable
    - `people` object[]: Not published by Zefix; empty in this phase.
    - `relationships` object[]
      - `kind` string
      - `uid` string, nullable
      - `ehraid` integer, nullable
      - `name` string, nullable
    - `not_provided_by_source` string[], required
    - `provenance` Provenance, required
      - `source` 'ZEFIX', required
      - `source_record_id` string, nullable
      - `source_url` string, nullable
      - `observed_at` string, date-time, required
      - `source_hash` string
      - `source_timestamp` string, nullable
  - `provenance` Provenance, required
    - `source` 'ZEFIX', required
    - `source_record_id` string, nullable
    - `source_url` string, nullable
    - `observed_at` string, date-time, required
    - `source_hash` string
    - `source_timestamp` string, nullable
  - `attribution` Attribution, required: Source attribution for Zefix-derived facts. Zefix data has no legal effect and is provided without guarantee.
    - `source` 'ZEFIX', required
    - `source_label` string
    - `source_reference` string
    - `source_record_id` string, nullable
    - `source_url` string, nullable
    - `retrieved_at` string, date-time, required
    - `source_timestamp` string, nullable
    - `legal_effect` false, required
    - `guaranteed` false, required
    - `notices` string[]
  - `bumit_derived_values` DerivedValue[]
    - `field` string, required
    - `source` 'ZEFIX', required
    - `source_value` unknown, required
    - `bumit_derived_value` unknown, required
    - `modified` true, required
    - `derivation` string
  - `disclaimer` Disclaimer, required
    - `legal_effect` false, required
    - `source_guarantees_data` false, required
    - `bumit_derived_fields_present` boolean
    - `statement` string, required
    - `notices` string[]
  - `freshness` Freshness, required: Cached evidence is never reported as LIVE.
    - `observed_at` string, date-time, nullable, required
    - `retrieved_at` string, date-time, nullable: Set only when this response came from a successful upstream call.
    - `source_timestamp` string, nullable
    - `age_seconds` integer, nullable
    - `max_age_hours` integer, nullable
    - `stale` boolean, required
    - `served_from_cache` boolean, required
    - `source_state` 'LIVE' | 'CACHED' | 'STALE' | 'DEGRADED' | 'UNAVAILABLE', required
    - `upstream_status` 'AVAILABLE' | 'NOT_CHECKED' | 'DEGRADED' | 'UNAVAILABLE' | 'NOT_CONFIGURED', required: Current upstream condition. NOT_CHECKED means this request was served cache-first and never contacted the source, so no availability claim is made; it is not a failure. Pair it with upstream_checked: false and source_state: CACHED.
    - `reason_code` 'INVALID_UID' | 'COMPANY_NOT_FOUND' | 'SOURCE_NOT_CONFIGURED' | 'SOURCE_UNAVAILABLE' | 'SOURCE_TIMEOUT' | 'SOURCE_RATE_LIMITED' | 'STALE_EVIDENCE' | 'INSUFFICIENT_EVIDENCE' | 'CAPABILITY_NOT_SUPPORTED' | 'CAPABILITY_NOT_AVAILABLE' | 'AUTHENTICATION_REQUIRED' | 'ACCESS_DENIED' | 'RATE_LIMITED' | 'UPSTREAM_DEGRADED' | 'INTERNAL_ERROR' | 'BAD_REQUEST' | 'PARTIAL_COVERAGE' | 'SANCTIONS_NO_DIRECT_MATCH' | 'SANCTIONS_POSSIBLE_MATCH' | 'SANCTIONS_CONFIRMED_MATCH' | 'SANCTIONS_DATA_UNAVAILABLE' | 'SANCTIONS_DATA_STALE' | 'SANCTIONS_SCHEMA_UNSUPPORTED' | 'SANCTIONS_CHECK_INCOMPLETE' | 'FINMA_LIST_UID_MATCH' | 'FINMA_LIST_UID_NOT_FOUND' | 'FINMA_LIST_UID_UNUSABLE' | 'FINMA_AUTHORISATION_DATA_UNAVAILABLE' | 'FINMA_AUTHORISATION_DATA_STALE' | 'FINMA_AUTHORISATION_DATA_INVALID' | 'FINMA_AUTHORISATION_CHECK_INCOMPLETE' | 'FINMA_WARNING_NO_DIRECT_MATCH' | 'FINMA_WARNING_POSSIBLE_MATCH' | 'FINMA_WARNING_DATA_UNAVAILABLE' | 'FINMA_WARNING_DATA_STALE' | 'FINMA_WARNING_DATA_INVALID' | 'FINMA_WARNING_CHECK_INCOMPLETE' | 'LEI_RECORD_FOUND' | 'LEI_RECORD_NOT_FOUND' | 'LEI_MULTIPLE_RECORDS' | 'LEI_LINKAGE_IDENTIFIER_UNUSABLE' | 'LEI_DATA_UNAVAILABLE' | 'LEI_DATA_INVALID' | 'LEI_DATA_STALE' | 'LEI_LOOKUP_INCOMPLETE' | 'VAT_ACTIVE_REGISTRATION' | 'VAT_INACTIVE_REGISTRATION' | 'VAT_NO_REGISTRATION' | 'VAT_STATUS_UNRECOGNISED' | 'VAT_EVIDENCE_CONTRADICTORY' | 'VAT_RECORD_NOT_FOUND' | 'VAT_MULTIPLE_SOURCE_RECORDS' | 'VAT_SUBJECT_UID_UNUSABLE' | 'VAT_DATA_UNAVAILABLE' | 'VAT_DATA_INVALID' | 'VAT_DATA_STALE' | 'VAT_CHECK_INCOMPLETE' | 'ADDRESS_OFFICIAL_MATCH' | 'ADDRESS_PLANNED_MATCH' | 'ADDRESS_OUTDATED_MATCH' | 'ADDRESS_NOT_FOUND' | 'ADDRESS_MULTIPLE_MATCHES' | 'ADDRESS_QUERY_UNUSABLE' | 'ADDRESS_STATUS_MISSING' | 'ADDRESS_STATUS_UNRECOGNISED' | 'ADDRESS_OFFICIAL_FLAG_NOT_SET' | 'ADDRESS_EVIDENCE_CONTRADICTORY' | 'ADDRESS_DATA_UNAVAILABLE' | 'ADDRESS_DATA_INVALID' | 'ADDRESS_DATA_STALE' | 'ADDRESS_CHECK_INCOMPLETE' | 'MANDATORY_CHECK_FAILED' | 'MANDATORY_CHECK_REVIEW' | 'MANDATORY_CHECK_UNKNOWN' | 'VERIFICATION_PROFILE_SATISFIED': Stable machine-readable reason identifier.
  - `meta` Meta
    - `service` string, required
    - `api_version` string, required
    - `trace_id` string, uuid, required
    - `generated_at` string, date-time, required

## Other responses

- `404`: No legal entity is registered for this UID
- `422`: The UID is not structurally valid
- `501`: No authoritative source is configured
- `503`: The commercial register is unavailable

---

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