---
title: "The AI earnings brief for a company's recent calls — a verifier-approved TL;DR, bullish and bearish points, verbatim pull-quotes, a deterministic narrative shift, and company-guidance updates plus reported results versus prior company guidance when available. Newest quarter first."
method: GET
path: "/v1/stocks/{ticker}/earnings-briefs"
tags: ["EarningsCalls"]
---

# The AI earnings brief for a company's recent calls — a verifier-approved TL;DR, bullish and bearish points, verbatim pull-quotes, a deterministic narrative shift, and company-guidance updates plus reported results versus prior company guidance when available. Newest quarter first.

`GET /v1/stocks/{ticker}/earnings-briefs`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/stocks/{ticker}/earnings-briefs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/stocks/:ticker/earnings-briefs/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `ticker` string, required

## Query parameters

- `limit` integer
- `fiscalYear` integer
- `fiscalQuarter` integer

## Response `200`

OK

- EarningsBriefDtoListResponse
  - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data.
    - `status` string, nullable: "delisted" or "renamed".
    - `ticker` string, nullable: The retired ticker as listed.
    - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known.
    - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted".
  - `data` EarningsBriefDto[], nullable
    - `fiscalYear` integer
    - `fiscalQuarter` integer
    - `callDate` string, date-time
    - `tldr` string, nullable
    - `bullish` string[], nullable
    - `bearish` string[], nullable
    - `narrativeShift` EarningsBriefNarrativeShiftDto
      - `priorFiscalYear` integer
      - `priorFiscalQuarter` integer
      - `derived` boolean
      - `newBullish` string[], nullable
      - `newBearish` string[], nullable
      - `noLongerRaised` string[], nullable
    - `guidanceComparison` EarningsBriefGuidanceComparisonDto
      - `issuedAtCall` EarningsBriefGuidanceReadingDto[], nullable
        - `filedDate` string, date
        - `form` string, nullable
        - `filingUrl` string, nullable
        - `items` CallGuidanceItemDto[], nullable
          - `metric` string, nullable
          - `period` string, nullable
          - `fiscalYear` integer, nullable
          - `fiscalQuarter` integer, nullable
          - `low` number, double, nullable
          - `high` number, double, nullable
          - `midpoint` number, double, nullable
          - `unit` string, nullable
          - `basis` string, nullable: "GAAP" or "Non-GAAP"; null when the release did not state a basis.
          - `fromTable` boolean
          - `quote` string, nullable
          - `actual` number, double, nullable
          - `actualVerdict` string, nullable
          - `actualIsDerived` boolean: True when the actual was derived arithmetically from reported facts (a Q4 figure computed as full year minus nine-month YTD) rather than read from a filed XBRL fact directly. False for filed facts and while actual is null.
          - `changeVsPrior` string, nullable
          - `priorGuidanceRange` CallGuidancePriorRangeDto
            - `filedDate` string, date
            - `low` number, double
            - `high` number, double
      - `reportedVsCompanyGuidance` EarningsBriefReportedGuidanceDto[], nullable
        - `guidanceFiledDate` string, date
        - `guidanceForm` string, nullable
        - `guidanceFilingUrl` string, nullable
        - `item` CallGuidanceItemDto
          - `metric` string, nullable
          - `period` string, nullable
          - `fiscalYear` integer, nullable
          - `fiscalQuarter` integer, nullable
          - `low` number, double, nullable
          - `high` number, double, nullable
          - `midpoint` number, double, nullable
          - `unit` string, nullable
          - `basis` string, nullable: "GAAP" or "Non-GAAP"; null when the release did not state a basis.
          - `fromTable` boolean
          - `quote` string, nullable
          - `actual` number, double, nullable
          - `actualVerdict` string, nullable
          - `actualIsDerived` boolean: True when the actual was derived arithmetically from reported facts (a Q4 figure computed as full year minus nine-month YTD) rather than read from a filed XBRL fact directly. False for filed facts and while actual is null.
          - `changeVsPrior` string, nullable
          - `priorGuidanceRange` CallGuidancePriorRangeDto
            - `filedDate` string, date
            - `low` number, double
            - `high` number, double
    - `quotes` BriefQuoteDto[], nullable
      - `text` string, nullable
      - `speakerName` string, nullable
      - `speakerRole` string, nullable
      - `startSeconds` number, double, nullable

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-11-06** `666e06778588`: 7 info
  - added the new optional `query` request parameter `fiscalQuarter`
  - added the new optional `query` request parameter `fiscalYear`
  - added the non-success response with the status `400`
  - added the optional property `data/items/guidanceComparison` to the response with the `200` status
  - …3 more

[Operation history](https://skmtc.dev/equibles/apis/equibles-api/changes/v1/stocks/:ticker/earnings-briefs/get.md)

---

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