---
title: "List Facts"
method: GET
path: "/v2/facts"
tags: ["v2"]
---

# List Facts

`GET /v2/facts`

## 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/v2/facts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/axioradev/apis/axiora-api/docs/v2/facts/get.ts> (a function with typed inputs; its response is checked against the schema)

Facts of one type, newest known first.

## Query parameters

- `type` string, nullable: Fact type (required). See /v2/types.
- `entity` string, nullable: Entity ID, e.g. company:E00883.
- `role` string, nullable: The entity's role in the fact, e.g. issuer.
- `since` string, nullable: valid_as_of on or after (YYYY-MM-DD).
- `until` string, nullable: valid_as_of on or before (YYYY-MM-DD).
- `as_of` string, nullable: Point in time: only facts known by then.
- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- FactList
  - `data` Fact[], required
    - `id` string, required: Stable fact ID.
    - `type` string, required
    - `subjects` Subject[], required
      - `entity` string, required: Entity ID, e.g. 'company:E00883'.
      - `role` string, required: Role in the fact, e.g. 'holder' or 'issuer'.
    - `valid_as_of` string, nullable: Date the fact describes.
    - `known_at` string, nullable: When the market could first know it.
    - `value` object, required
    - `superseded_by` string, nullable
    - `source` Source, required
      - `doc_id` string, nullable: Filing the value came from.
      - `doc_type` string, nullable: Document type code, e.g. '350'.
      - `filed_at` string, nullable: When the filing was submitted (ISO 8601).
      - `url` string, nullable: The filing on EDINET.
      - `section` string, nullable: Section of the filing, where kept.
      - `quote` string, nullable: Quoted line, where kept.
      - `read_by` 'kiri', nullable: 'kiri' when Kiri read the value.
    - `status` 'confirmed' | 'held', required
    - `held_reason` string, nullable
  - `meta` AxioraApiV2ModelsMeta, required
    - `request_id` string, required
    - `data_as_of` string, nullable: Source data date of the snapshot served.
    - `data_version` string, nullable: Snapshot version served.
    - `next_cursor` string, nullable
    - `resolved_from` string, nullable: The identifier sent, when it was not the canonical id in data.id.
    - `deprecations` object[]
    - `caveats` string[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-26** `c63b444101ae`: 1 info
  - added the optional property `meta/resolved_from` to the response with the `200` status
- **2026-10-21** `be1df0eb1fd5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axioradev/apis/axiora-api/changes/v2/facts/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)