---
title: "List Company Trajectories"
method: GET
path: "/v1/companies/{code}/ownership/trajectories"
tags: ["ownership"]
---

# List Company Trajectories

`GET /v1/companies/{code}/ownership/trajectories`

Get all filer trajectories for an issuer.

Returns ownership trajectory data for each filer that holds >=5% of the company.

## Path parameters

- `code` string, required — Securities code (e.g. '7203') or EDINET code (e.g. 'E02144')

## Query parameters

- `trajectory_type` string, nullable — Filter: accumulating, exiting, stable, new_position
- `date_from` string, date, nullable — Filter: last_base_date on or after
- `date_to` string, date, nullable — Filter: last_base_date on or before
- `limit` integer — Results per page
- `offset` integer — Results to skip (ignored when cursor is set)
- `cursor` string, nullable — Opaque cursor for keyset pagination

## Response `200`

Successful Response

- ListResponseTrajectoryOut
  - `data` TrajectoryOut[], required — Array of result objects.
    - `issuer_security_code` string, required — Securities code of the issuer
    - `issuer_name` string, nullable — Name of the issuer
    - `filer_canonical_code` string, required — Canonical EDINET code of the filer
    - `filer_name` string, nullable — Name of the filer
    - `latest_holding_ratio_pct` number, nullable — Latest holding ratio
    - `delta_90d_pct` number, nullable — Change in holding ratio over 90 days
    - `delta_180d_pct` number, nullable — Change in holding ratio over 180 days
    - `delta_1y_pct` number, nullable — Change in holding ratio over 1 year
    - `trajectory_type` string, required — accumulating, exiting, stable, or new_position
    - `streak_length` integer, required — Consecutive filings in current direction
    - `velocity_pp_per_month` number, required — Percentage points change per month
    - `purpose_category` string, nullable — Latest classified purpose
    - `first_base_date` string, date, nullable — Date of first filing
    - `last_base_date` string, date, nullable — Date of most recent filing
    - `filing_count` integer, required — Total number of filings
    - `points` TrajectoryPointOut[], nullable — Full trajectory points (only in detail endpoint)
      - `base_date` string, date, required — Date of the shareholding report
      - `holding_ratio_pct` number, required — Holding ratio as percentage
      - `delta_pct` number, required — Change from previous point in pp
      - `shares_held` integer, nullable — Shares held
      - `purpose_category` string, nullable — Classified purpose
      - `report_type` string, required — Report type
      - `doc_id` string, nullable — EDINET document ID (e.g. 'S100ABCD')
  - `meta` Meta, required
    - `total` integer, nullable — Total number of matching records (list endpoints only).
    - `limit` integer, nullable — Maximum records returned per page.
    - `offset` integer, nullable — Number of records skipped (offset-based pagination).
    - `next_cursor` string, nullable — Opaque cursor for the next page (keyset pagination). Null on the last page.
    - `request_id` string, required — Unique request identifier for tracing and support (e.g. 'req_abc123').

## Other responses

- `422` — Validation Error

## Changes

- **2026-03-31** `debdd9fbc570` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/axioradev/apis/axiora-api/changes/v1/companies/:code/ownership/trajectories/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/b8bf48556541?raw)