---
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
    - `company` CompanyOut, required
      - `edinet_code` string, required
      - `securities_code` string, nullable
      - `name_jp` string, required
      - `name_en` string, nullable
      - `sector` string, nullable
      - `sector_en` string, nullable
      - `fiscal_year_end` string, nullable
      - `listing` string, nullable
      - `listing_en` string, nullable
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `financials` ScreenFinancials, required
      - `fiscal_year` integer, required
      - `revenue` integer, nullable
      - `gross_profit` integer, nullable
      - `net_income` integer, nullable
      - `operating_income` integer, nullable
      - `total_assets` integer, nullable
      - `total_equity` integer, nullable
      - `total_liabilities` integer, nullable
      - `current_assets` integer, nullable
      - `current_liabilities` integer, nullable
    - `metrics` ScreenMetrics, required
      - `roe` number, nullable
      - `roa` number, nullable
      - `operating_margin` number, nullable
      - `net_margin` number, nullable
      - `equity_ratio` number, nullable
  - `meta` Meta, required
    - `total` integer, nullable
    - `limit` integer, nullable
    - `offset` integer, nullable
    - `next_cursor` string, nullable
    - `request_id` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-02-25** `5bdc8f1d1f3e` — 3 info
  - added the optional property `data/items/financials/current_assets` to the response with the `200` status
  - added the optional property `data/items/financials/current_liabilities` to the response with the `200` status
  - added the optional property `data/items/financials/gross_profit` to the response with the `200` status

[Change history](https://skmtc.dev/axioradev/apis/axiora-api/changes/v1/screen/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-service-production.skmtc.workers.dev/v1/apis/axioradev/axiora-api/revisions/af89affc4582/schema)