---
title: "Get Shareholding Audit"
method: GET
path: "/v1/shareholdings/{shareholding_id}/audit"
tags: ["shareholdings"]
---

# Get Shareholding Audit

`GET /v1/shareholdings/{shareholding_id}/audit`

## Request

- Base URL: `https://api.axiora.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.axiora.dev/v1/shareholdings/{shareholding_id}/audit`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/axioradev/apis/axiora-api/docs/v1/shareholdings/:shareholding_id/audit/get.ts> (a function with typed inputs; its response is checked against the schema)

Full audit bundle for a single shareholding row.

Returns the row's classification with the full provenance chain:
real-time view (knowable at filing time), retrospective view
(revealed by later evidence on the same filer × issuer pair),
confidence, the source filing reference,
and a stable version label for how the row was read, which consumers
can pin to.

To freeze a response: capture `meta.as_of` from one call, then
pass it back as `?as_of=<token>` on later calls: you'll get the
same answer regardless of how the data has evolved. Two calls
that share the same `as_of` are guaranteed bit-identical.

## Path parameters

- `shareholding_id` integer, required: Row id from /companies/{code}/shareholdings.

## Query parameters

- `as_of` string, nullable: Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer. Omit for the live view.

## Response `200`

Successful Response

- SingleResponseShareholdingAuditOut
  - `data` ShareholdingAuditOut, required: Full audit bundle for a single shareholding row. Returned by GET /shareholdings/{id}/audit. Combines the row's real-time and retrospective views, the calibrated confidence, the source filing reference, and the reading's version label into one self-contained object that institutional consumers can cite or pin.
    - `shareholding_id` integer, required: Row identifier.
    - `source` object, required: Filing reference. Includes doc_id (EDINET), filer EDINET code, issuer security code, and base_date. Every claim in this bundle traces to this filing.
    - `realtime` object, required: What was knowable at filing time. Includes predicted_category (= holding_purpose_category), confidence, and as_of_date (= source.base_date).
    - `retrospective` object, nullable: What later evidence revealed. Same shape as realtime but predicted_category may differ when later filings from the same filer × issuer disclosed a more-active intent. evidence_cutoff_date marks the latest filing used. Null when no later evidence existed.
    - `classifier_version` string, nullable: Opaque version label for how this row was read.
  - `meta` AxioraApiSchemasMeta, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `996d12eb9cb3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axioradev/apis/axiora-api/changes/v1/shareholdings/:shareholding_id/audit/get.md)

---

[API](https://skmtc.dev/axioradev/apis/axiora-api.md) - [All operations](https://skmtc.dev/axioradev/apis/axiora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/axioradev/apis/axiora-api/revisions/47e27a7f92de?raw)