---
title: "Screen Companies"
method: GET
path: "/v1/screen"
tags: ["screening"]
---

# Screen Companies

`GET /v1/screen`

## Query parameters

- `roe_min` number, nullable
- `roe_max` number, nullable
- `roa_min` number, nullable
- `roa_max` number, nullable
- `revenue_min` integer, nullable
- `revenue_max` integer, nullable
- `net_income_min` integer, nullable
- `net_income_max` integer, nullable
- `operating_income_min` integer, nullable
- `operating_income_max` integer, nullable
- `sector` string, nullable
- `sort` string
- `fiscal_year` integer, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- ListResponseScreenResultOut
  - `data` ScreenResultOut[], required — Array of result objects.
    - `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.
      - `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.
      - `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.
    - `financials` ScreenFinancials, required
      - `fiscal_year` integer, required — Fiscal year of the financial data.
      - `revenue` integer, nullable — Revenue in JPY.
      - `gross_profit` integer, nullable — Gross profit in JPY.
      - `net_income` integer, nullable — Net income in JPY.
      - `operating_income` integer, nullable — Operating income in JPY.
      - `total_assets` integer, nullable — Total assets in JPY.
      - `total_equity` integer, nullable — Total equity in JPY.
      - `total_liabilities` integer, nullable — Total liabilities in JPY.
      - `current_assets` integer, nullable — Current assets in JPY.
      - `current_liabilities` integer, nullable — Current liabilities in JPY.
    - `metrics` ScreenMetrics, required
      - `roe` number, nullable — Return on equity (%).
      - `roa` number, nullable — Return on assets (%).
      - `operating_margin` number, nullable — Operating margin (%).
      - `net_margin` number, nullable — Net margin (%).
      - `equity_ratio` number, nullable — Equity ratio (%).
  - `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

---

[API](https://skmtc.net/axioradev/apis/axiora-api.md) · [All operations](https://skmtc.net/axioradev/apis/axiora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axioradev/axiora-api/revisions/b8bf48556541/schema)