---
title: "Get Forecasts"
method: GET
path: "/v1/companies/{code}/forecasts"
tags: ["earnings"]
---

# Get Forecasts

`GET /v1/companies/{code}/forecasts`

Get management earnings forecasts (業績予想) for a company.

Extracted from 決算短信 XBRL — the forward guidance management provides
alongside their earnings release. Only returns snapshots that contain
at least one forecast field.

## Path parameters

- `code` string, required

## Query parameters

- `years` integer

## Response `200`

Successful Response

- ListResponseEarningsForecastOut
  - `data` EarningsForecastOut[], required — Array of result objects.
    - `securities_code` string, nullable
    - `company_name` string, nullable
    - `company_name_en` string, nullable
    - `fiscal_year_end` string, nullable
    - `period_type` string, nullable
    - `filing_date` string, nullable
    - `accounting_standard` string, nullable
    - `forecast_revenue` integer, nullable
    - `forecast_operating_income` integer, nullable
    - `forecast_ordinary_income` integer, nullable
    - `forecast_net_income` integer, nullable
    - `forecast_eps` number, nullable
    - `forecast_revenue_change_pct` number, nullable
    - `forecast_operating_income_change_pct` number, nullable
    - `forecast_net_income_change_pct` number, nullable
  - `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)