---
title: "List Entities"
method: GET
path: "/v2/entities"
tags: ["v2"]
---

# List Entities

`GET /v2/entities`

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

Entities of one type, optionally filtered by name or code.

## Query parameters

- `type` string, required: Entity type: company, holder or filing.
- `q` string, nullable: Name or code contains.
- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- EntityList
  - `data` Entity[], required
    - `id` string, required: Entity ID, e.g. 'company:E00883' or 'holder:E06485'.
    - `type` string, required
    - `name` string, nullable
    - `name_jp` string, nullable
    - `attributes` object
    - `ids` object: Every public identifier held for the entity (EDINET code, securities code, 法人番号, LEI, the v1 filer code). Any of them works as input. Null means none is held.
    - `facts` object, nullable
    - `facts_more` object, nullable: For an included fact type capped at 50: the /v2/facts link for the rest.
    - `status` 'confirmed' | 'held'
    - `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`: 2 info
  - added the optional property `data/items/ids` to the response with the `200` status
  - 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/entities/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)