Transcript KPIs

GET/v1/earnings/transcripts/{transcriptId}/kpisPromised whole

Operating figures stated on one call, each tied to what was said.

Parameters

transcriptIdpathrequired
Transcript identifier, as returned by the transcript list.

Response contract

Every field in the response is part of the contract.

Response fields

The top level keys a live response actually returned, read off the API rather than written down here.

transcript_idsymbolperiodsrowsdegraded

How this was verified

Called against 4 different subjects on the live API. Every field it returned, at every level, was compared with the contract above. Last checked August 18, 2026.

Request

curl "https://api.massari.ai/v1/earnings/transcripts/fee85159-ec7e-4583-a0bf-2410e5a4fc6d/kpis" \
  -H "Authorization: Bearer $MASSARI_TOKEN"

Example response

{
  "transcript_id": "fee85159-ec7e-4583-a0bf-2410e5a4fc6d",
  "symbol": "AAPL",
  "periods": [
    "2026-06-27",
    "2026-03-28"
  ],
  "rows": [
    {
      "key": "revenue",
      "label": "Revenue",
      "unit": "USD",
      "cells": [
        {
          "period": "2026-06-27",
          "value": 109417000000,
          "display": null,
          "source_kind": "filing",
          "derived": null,
          "derived_from": null,
          "tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
          "adsh": "0000320193-26-000020",
          "uom": "USD",
          "qtrs": 1,
          "duration": null
        },
        {
          "period": "2026-03-28",
          "value": 111184000000,
          "display": null,
          "source_kind": "filing",
          "derived": null,
          "derived_from": null,
          "tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
          "adsh": "0000320193-26-000013",
          "uom": "USD",
          "qtrs": 1,
          "duration": null
        }
      ],
      "commentary": "Management reported revenue of $109.4 billion, up 16% from a year ago and a June quarter record.",
      "commentary_source_kind": "call",
      "commentary_transcript_id": "fee85159-ec7e-4583-a0bf-2410e5a4fc6d",
      "commentary_period": "Q3 FY2026"
    },
    {
      "key": "gross_profit",
      "label": "Gross profit",
      "unit": "USD",
      "cells": [
        {
          "period": "2026-06-27",
          "value": 54770000000,
          "display": null,
          "source_kind": "filing",
          "derived": null,
          "derived_from": null,
          "tag": "GrossProfit",
          "adsh": "0000320193-26-000020",
          "uom": "USD",
          "qtrs": 1,
          "duration": null
        },
        {
          "period": "2026-03-28",
          "value": 54781000000,
          "display": null,
          "source_kind": "filing",
          "derived": null,
          "derived_from": null,
          "tag": "GrossProfit",
          "adsh": "0000320193-26-000013",
          "uom": "USD",
          "qtrs": 1,
          "duration": null
        }
      ],
      "commentary": null,
      "commentary_source_kind": null,
      "commentary_transcript_id": null,
      "commentary_period": null
    }
  ],
  "degraded": false
}

A real response from the live API, captured August 18, 2026. This one is CUT: long arrays, wide objects and long strings were trimmed to keep it readable, so treat it as a sample of the shape rather than all of it. Either way it is valid JSON.