---
title: "Stock AI Earnings Report (Pro)"
method: GET
path: "/api/v1/stocks/{ticker}/earnings"
tags: ["Stocks"]
---

# Stock AI Earnings Report (Pro)

`GET /api/v1/stocks/{ticker}/earnings`

## Request

- Base URL: `https://foliofact.com`
- URL: `https://foliofact.com/api/v1/stocks/{ticker}/earnings`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

The latest cited AI Earnings Report for one company (or a stable period with `period`). Requires FolioFact Pro, which receives the complete evidence-linked analysis.

## Path parameters

- `ticker` string, required

## Query parameters

- `period` string

## Response `200`

Complete AI Earnings Report

- StockEarnings
  - `ticker` string, required
  - `name` string, nullable, required
  - `access` 'teaser' | 'full', required
  - `report` EarningsReport, required
    - `period` EarningsPeriod, required
      - `slug` string, required
      - `label` string, required
      - `kind` 'quarter' | 'half_year' | 'annual', required
      - `end_on` string, date, required
    - `revision` integer, required
    - `published_at` string, date-time, nullable, required
    - `teaser` EarningsTeaser, required
      - `headline` string, required
      - `summary` string, required
      - `highlights` string[], required
    - `body` EarningsBody, required
      - `headline` EarningsClaim, required
        - `text` string, nullable, required
        - `source_ids` string[], required
      - `summary` EarningsClaim, required
        - `text` string, nullable, required
        - `source_ids` string[], required
      - `highlights` EarningsClaim[], required
        - `text` string, nullable, required
        - `source_ids` string[], required
      - `metrics` EarningsMetric[], required
        - `label` string, nullable, required
        - `value` string, nullable, required
        - `comparison` string, nullable, required
        - `source_ids` string[], required
      - `key_changes` EarningsChange[], required
        - `title` string, nullable, required
        - `text` string, nullable, required
        - `source_ids` string[], required
      - `management` EarningsClaim, required
        - `text` string, nullable, required
        - `source_ids` string[], required
      - `guidance` EarningsGuidance, required
        - `text` string, nullable, required
        - `source_ids` string[], required
        - `status` string, nullable, required
      - `risks` EarningsClaim[], required
        - `text` string, nullable, required
        - `source_ids` string[], required
      - `historical_context` EarningsClaim, required
        - `text` string, nullable, required
        - `source_ids` string[], required
      - `limitations` string[], required
    - `sources` EarningsSource[], required
      - `id` string, required
      - `title` string, required
      - `form_type` string, required
      - `filing_item` string, nullable, required
      - `official_url` string, uri, required
      - `filed_on` string, date, nullable, required
      - `accepted_at` string, date-time, nullable, required
      - `content_digest` string, required
    - `generation` EarningsGeneration, required
      - `model_id` 'opencode/big-pickle', required
      - `opencode_version` string, nullable, required
      - `schema_version` string, required
      - `prompt_version` string, required

## Other responses

- `403`: Structured error
- `404`: Structured error
- `429`: Rate limit exceeded
- `default`: Structured error

---

[API](https://skmtc.dev/foliofact/apis/foliofact-api.md) · [All operations](https://skmtc.dev/foliofact/apis/foliofact-api/llms.txt) · [OpenAPI document](https://skmtc.dev/foliofact/apis/foliofact-api/revisions/a92e927f23f4?raw)