---
title: "Historical commercial-register publications (SHAB/SOGC) for a UID"
method: GET
path: "/api/v1/company/{uid}/events"
deprecated: true
---

# Historical commercial-register publications (SHAB/SOGC) for a UID

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

## Request

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

> **Deprecated.**

Returns stored SHAB/SOGC publications for one canonical UID, newest publication first.

A publication is historical evidence of what was published at a point in time. It never states current company state (`describes_current_state` is always false) and never establishes registered persons or signature authority (`signatory_authority_covered` is always false). Publication prose is retained only as raw source evidence and is never interpreted: no claim in this response is derived from free text, and no INFERRED claim is produced.

Event types are limited to those a structured publication element establishes deterministically: REGISTRATION, DELETION, OTHER_HR_PUBLICATION and UNCLASSIFIED. `classification_basis` names the structured element used.

Company linkage uses the canonical UID only; BUMIT never matches a company by name. `company_link_status` is `LINKED` only when the canonical UID resolved to a stored BUMIT company, `UID_IDENTIFIED` when the publication carries a structured UID that is not (yet) resolved to a stored company, and `UNRESOLVED` when the publication carries no structured UID at all.

Live and scheduled SHAB ingestion is currently disabled, so coverage is limited to publications already ingested and an empty result is never evidence that no publication exists (`reason_codes: [INSUFFICIENT_EVIDENCE]`).

## Path parameters

- `uid` string, required

## Query parameters

- `limit` integer

## Response `200`

Chronological publication history with provenance, attribution and coverage.

- CompanyEventsResponse
  - `status` 'OK', required
  - `uid` string, required
  - `uid_checksum_valid` boolean
  - `source` 'SHAB', required
  - `order` 'PUBLICATION_DATE_DESC', required
  - `count` integer, required
  - `limit` integer
  - `events` RegistryEvent[], required
    - `event_id` string, nullable
    - `event_type` 'REGISTRATION' | 'DELETION' | 'OTHER_HR_PUBLICATION' | 'UNCLASSIFIED', required
    - `classification_basis` string
    - `uid` string, nullable, required
    - `company_link_status` 'LINKED' | 'UID_IDENTIFIED' | 'UNRESOLVED', required
    - `company_name` string, nullable
    - `publication` object, required
    - `prior_publications` object[]
    - `claims` Claim[], required
      - `attribute` string, required
      - `value` unknown, required
      - `claim_type` 'SOURCE_FACT' | 'NORMALIZED' | 'DERIVED' | 'INFERRED' | 'UNAVAILABLE', required: SOURCE_FACT published by the source; NORMALIZED deterministic transformation; DERIVED deterministic BUMIT conclusion; INFERRED probabilistic and not stated by the source; UNAVAILABLE required evidence missing.
      - `inference_used` boolean, required
      - `source` string, nullable
      - `source_record_id` string, nullable
      - `source_url` string, nullable
      - `observed_at` string, date-time, nullable
      - `valid_from` string, nullable
      - `valid_to` string, nullable
      - `source_hash` string, nullable
      - `confidence` number
      - `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.
    - `provenance` RegistryEventProvenance, required
      - `source` 'SHAB', required
      - `source_record_id` string, required: Publication UUID as published by the source.
      - `source_url` string, nullable
      - `schema_version` string, required: SHAB XML schema version the payload declared, e.g. 1.26.
      - `source_hash` string, required: SHA-256 of the raw publication payload; the idempotency identity.
      - `observed_at` string, date-time, required
    - `attribution` object
    - `legal_effect` unknown
    - `describes_current_state` unknown
  - `coverage` object, required
  - `describes_current_state` unknown
  - `signatory_authority_covered` unknown
  - `inference_used` unknown
  - `reason_codes` string[]
  - `legal_effect` unknown
  - `disclaimer` object
  - `meta` Meta
    - `service` string, required
    - `api_version` string, required
    - `trace_id` string, uuid, required
    - `generated_at` string, date-time, required

## Other responses

- `400`: Invalid limit.
- `422`: Structurally invalid UID.
- `501`: The gazette source is not configured in this deployment; the capability is supported but 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)