---
title: "Get Company Earnings Signals"
method: GET
path: "/v1/companies/{code}/earnings/signals"
tags: ["earnings"]
---

# Get Company Earnings Signals

`GET /v1/companies/{code}/earnings/signals`

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

Get earnings signals for a company (beats, misses, revisions, records).

## Path parameters

- `code` string, required

## Query parameters

- `signal_type` string, nullable: Filter: earnings_beat, earnings_miss, forecast_revision_up, forecast_revision_down, record_revenue, margin_expansion, margin_contraction
- `limit` integer

## Response `200`

Successful Response

- ListResponseEarningsSignalOut
  - `data` EarningsSignalOut[], required: Array of result objects.
    - `signal_type` string, nullable
    - `securities_code` string, nullable
    - `company_name` string, nullable
    - `detected_date` string, nullable
    - `tdnet_pdf_url` string, nullable: URL of the source TDnet document (決算短信 or 業績予想の修正) that triggered this signal.
    - `fiscal_year_end` string, nullable
    - `period_type` string, nullable
    - `is_consolidated` boolean, nullable: True for consolidated figures, false for parent-only.
    - `metric` string, nullable
    - `actual_value` number, nullable
    - `expected_value` number, nullable
    - `surprise_pct` number, nullable
    - `metadata` object, nullable
  - `meta` AxioraApiSchemasMeta, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `996d12eb9cb3`: 1 breaking, 4 warning, 3 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
  - …4 more
- **2026-03-31** `47575447accf`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `data` to the response with the `200` status
  - added the required property `meta` to the response with the `200` status
- **2026-03-31** `debdd9fbc570`: 1 info
  - endpoint added

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