---
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`

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
    - `fiscal_year_end` string, nullable
    - `period_type` string, nullable
    - `metric` string, nullable
    - `actual_value` number, nullable
    - `expected_value` number, nullable
    - `surprise_pct` number, nullable
    - `metadata` object, 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)
