> ## Documentation Index
> Fetch the complete documentation index at: https://doc.astreus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Transcripts & guidance

> Earnings-call transcripts and audio, span-anchored observations, and what management promised scored against what happened.

Earnings calls are ingested from licensed transcript providers and issuers' own investor
sites, then read twice: once into **observations** — verified statements anchored to the
exact passage they came from — and once into **guidance commitments**, the forward-looking
promises management made, which are later resolved against the reported numbers.

## Transcripts

```
GET /api/v1/companies/{id}/transcripts
```

The index: one row per call with `id`, `date`, `fiscalYear`, `fiscalQuarter`,
`quarterLabel`, `eventDatetime`, `startTimeLabel` (the start in the issuer's market clock,
e.g. `4:30 PM ET`), `durationSeconds` and `hasAudio`. Non-results events (conference talks,
investor days, special calls) carry `eventType`, `kindLabel` (`Conference`) and `eventLabel`
(the conference the talk was given at). Some issuers hold two calls on one earnings day —
Micron's results call at 4:30 PM ET and its post-earnings analyst call at 6:00 PM ET — so
never dedupe on the quarter; the start time tells them apart. Calls come from several
sources (licensed providers, issuer investor-relations sites, recordings transcribed by the
platform), merged into one list.

```
GET /api/v1/companies/{id}/transcripts/{transcriptId}?date=YYYY-MM-DD
```

The call as `text/plain` with speaker turns. **`date` is required** — take it from the
index. `astreus transcript NVDA` and the MCP tool `get_transcript` look the date up for you
and default to the most recent call.

```
GET /api/v1/companies/{id}/transcripts/{transcriptId}/audio?date=YYYY-MM-DD
```

The webcast recording where one is stored (`hasAudio` in the index). Honours `Range`
requests and returns `Accept-Ranges: bytes`, so it streams in a browser or player.

<Note>
  Transcript text is licensed content served for your own use. Redistributing full
  transcripts, or building an archive of them, needs a separate agreement — see the
  [terms](https://astreus.ai/terms).
</Note>

## Observations

```
GET /api/v1/companies/{id}/transcripts/{transcriptId}/annotations
GET /api/v1/companies/{id}/observations?family=&includeReview=1
```

An observation is a claim extracted from a call or a filing that passed verification: it
points into the exact span of source text it was taken from, so it can be checked. The
transcript route returns the observations on one call; the company route returns
observations across every source, optionally filtered by event `family` (the same
vocabulary as 8-K events — see [Events & news](/events-and-news)), and including items
still under review when `includeReview=1`.

## Guidance

```
GET /api/v1/companies/{id}/earnings/promises     # open commitments from the latest calls
GET /api/v1/companies/{id}/earnings/scorecard    # per-call record of commitments kept vs missed
GET /api/v1/companies/{id}/earnings/overview     # latest call, market reaction, headline commitments
```

A commitment is a specific, checkable statement about a future period — a revenue range, a
margin target, a delivery date. Each is extracted, gated, row-audited before it is served,
and later resolved when the period reports: kept, missed, or withdrawn. The scorecard is the
company's track record; `astreus guidance NVDA` and the MCP tool `get_guidance` return the
commitments and the scorecard together.

The same resolutions roll up two ways:

```
GET /api/v1/scorecards/events?ticker=&withCommitments=true&limit=
GET /api/v1/scorecards/events/{id}
GET /api/v1/scorecards/executives
GET /api/v1/scorecards/executives/{name}
```

Scored earnings events (an event is one call with its guidance outcomes), and an executive
leaderboard — guidance kept versus missed by the person who gave it, with the minimum
number of predictions before a rate is shown returned as `min_predictions_for_rate`.

```
GET /api/v1/companies/{id}/scorecard
GET /api/v1/companies/{id}/signals
```

`scorecard` is the company-level guidance-versus-actual summary; `signals` gathers the
derived signals the terminal shows on a company — insider activity, ownership shifts,
guidance credibility and earnings reactions — in one payload.

## Investor presentations

Decks furnished with results are served alongside the calls — see
[Investor presentations](/investor-presentations).