---
title: "Get Ranking"
method: GET
path: "/v1/rankings/{metric}"
tags: ["rankings"]
---

# Get Ranking

`GET /v1/rankings/{metric}`

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

Rank companies by a financial metric.

Returns top N companies sorted by the chosen metric, with the
metric value and basic company info.

## Path parameters

- `metric` string, required

## Query parameters

- `sector` string, nullable: Filter by sector
- `fiscal_year` integer, nullable
- `order` string
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- ListResponseRankingResultOut
  - `data` RankingResultOut[], required: Array of result objects.
    - `rank` integer, required: Position in the ranking (1-based).
    - `company` CompanyOut, required
      - `edinet_code` string, required: EDINET submitter code assigned by FSA (e.g. 'E02144'). Primary identifier.
      - `securities_code` string, nullable: TSE securities code, 4 digits (e.g. '7203').
      - `name_jp` string, required: Company name in Japanese (e.g. 'トヨタ自動車株式会社').
      - `name_en` string, nullable: Company name in English. Null if not provided in filings.
      - `name_en_quality` string, nullable: Audit tag for `name_en`. One of: 'verified' (from an authoritative external registry), 'derived' (deterministic extraction or high-confidence public-registry match), 'machine' (model-generated, lowest confidence). Null when no English name has been resolved yet.
      - `name_en_resolved_at` string, date-time, nullable: Timestamp `name_en` was last resolved. Use to detect staleness.
      - `sector` string, nullable: TSE 33-sector classification in Japanese (e.g. '輸送用機器').
      - `sector_en` string, nullable: TSE 33-sector in English. Auto-translated.
      - `fiscal_year_end` string, nullable: Fiscal year-end month as 2-digit string (e.g. '03' for March).
      - `listing` string, nullable: TSE market segment in Japanese (e.g. 'プライム（内国株式）').
      - `listing_en` string, nullable: TSE market segment in English (e.g. 'Prime'). Auto-translated from listing.
      - `sector_display` string: Always-populated display label derived from sector + listing. TSE's 33-sector classification only applies to listed equities; unlisted filers (REITs, asset managers, foreign subs) carry no sector. This field surfaces that gap explicitly: 'Unlisted' when listing is null, 'Uncategorised' when listed but unclassified, otherwise the English sector name. Consumers needing the raw TSE classification should still read `sector` / `sector_en`.
      - `entity_type` string, nullable: Entity classification: 'listed_company', 'fund', or 'unlisted_filer'.
      - `created_at` string, date-time, required: When this company record was first created in Axiora.
      - `updated_at` string, date-time, required: When this company record was last updated.
    - `fiscal_year` integer, required: Fiscal year of the ranked value.
    - `value` union: The metric value used for ranking.
      - number
      - integer
    - `metric` string, required: Which metric was used (e.g. 'revenue', 'roe').
  - `meta` AxioraApiSchemasMeta, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `996d12eb9cb3`: 1 breaking, 4 warning, 4 info
  - removed the required property `meta/request_id` from the response with the `200` status
  - removed the optional property `meta/limit` from the response with the `200` status
  - removed the optional property `meta/next_cursor` from the response with the `200` status
  - removed the optional property `meta/offset` from the response with the `200` status
  - …5 more
- **2026-03-31** `debdd9fbc570`: 1 warning
  - for the `path` request parameter `metric`, the maxLength was set to `30`

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