---
title: "Get Forecast Revisions"
method: GET
path: "/v1/companies/{code}/forecast-revisions"
tags: ["earnings"]
---

# Get Forecast Revisions

`GET /v1/companies/{code}/forecast-revisions`

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

Get previous and revised management guidance from official revision notices.

Monetary values are integer JPY. EPS is JPY per share. Target periods and
consolidated/nonconsolidated guidance remain separate. Null means no reported
numeric value; *_unreported_fields identifies explicitly nil or dash facts.
Pagination follows captured source notices. Sources includes PDF-only and
held notices; data contains structured guidance for parsed sources on that
page. This endpoint covers captured notices, not full history.

## Path parameters

- `code` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- ForecastRevisionResponse
  - `data` ForecastRevisionNotice[], required
    - `securities_code` string, required
    - `company_name` string, required
    - `published_at` string, date-time, required
    - `fiscal_year_end` string, date, required
    - `title` string, required
    - `notice` string, required
    - `reason` string, required
    - `notes` string, required
    - `tdnet_pdf_url` string, required
    - `revisions` GuidanceRevision[], required
      - `period_type` 'FY' | 'Q2', required
      - `period_start` string, date, required
      - `period_end` string, date, required
      - `accounting_standard` 'JP-GAAP' | 'IFRS', required
      - `is_consolidated` boolean, required
      - `previous` GuidanceValues, required: Monetary amounts are integer JPY; EPS is JPY per share.
        - `revenue` integer, nullable
        - `operating_revenues` integer, nullable
        - `gross_operating_revenues` integer, nullable
        - `bank_ordinary_revenues` integer, nullable
        - `operating_income` integer, nullable
        - `ordinary_income` integer, nullable
        - `profit_before_tax` integer, nullable
        - `profit` integer, nullable
        - `net_income` integer, nullable
        - `eps` number, nullable
      - `current` GuidanceValues, required: Monetary amounts are integer JPY; EPS is JPY per share.
        - `revenue` integer, nullable
        - `operating_revenues` integer, nullable
        - `gross_operating_revenues` integer, nullable
        - `bank_ordinary_revenues` integer, nullable
        - `operating_income` integer, nullable
        - `ordinary_income` integer, nullable
        - `profit_before_tax` integer, nullable
        - `profit` integer, nullable
        - `net_income` integer, nullable
        - `eps` number, nullable
      - `previous_unreported_fields` string[], required
      - `current_unreported_fields` string[], required
  - `sources` ForecastSourceNotice[], required
    - `published_at` string, date-time, required
    - `title` string, required
    - `tdnet_pdf_url` string, required
    - `disposition` 'parsed' | 'archive_only' | 'held', required
  - `meta` ForecastRevisionMeta, required
    - `request_id` string, required
    - `computation_version` string
    - `ontology_version` string
    - `data_as_of` string, date-time, nullable, required: Latest captured source publication time; null when source_total is zero.
    - `total` integer, required
    - `limit` integer, required
    - `offset` integer, required
    - `caveats` string[], required
    - `securities_code` string, required
    - `source_total` integer, required
    - `parsed_count` integer, required
    - `archive_only_count` integer, required
    - `held_count` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-23** `129aad3a07e7`: 1 info
  - the `ontology_version` response's property default value changed from `3.1.0` to `3.2.0` for the status `200`
- **2026-10-16** `996d12eb9cb3`: 1 info
  - endpoint added

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