---
title: "Get Company Temporal State"
method: GET
path: "/companies/{ticker}/state"
tags: ["company state"]
---

# Get Company Temporal State

`GET /companies/{ticker}/state`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/companies/{ticker}/state`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Read already-shared company state only; this endpoint is never a model call.

## Path parameters

- `ticker` string, required

## Response `200`

Successful Response

- CompanyTemporalStateOut
  - `ticker` string, required
  - `promises` ManagementPromiseOut[]
    - `id` integer, required
    - `topic_key` string, required
    - `topic` string, required
    - `first_observed_at` string, date-time, required
    - `observations` ManagementPromiseObservationOut[]
      - `id` integer, required
      - `status` 'introduced' | 'reiterated' | 'raised' | 'lowered' | 'withdrawn' | 'delivered' | 'missed', required
      - `statement` string, required
      - `prior_statement` string, nullable, required
      - `timeframe` string, nullable, required
      - `evidence_quote` string, required
      - `source_speaker` string, nullable
      - `evidence_source_segment_id` integer, nullable
      - `source_artifact_version_id` integer, nullable
      - `source_call_id` string, required
      - `source_title` string, required
      - `source_occurred_at` string, date-time, required
      - `observed_at` string, date-time, required
      - `source_url` string, required
      - `prior_evidence_quote` string, nullable
      - `prior_source_speaker` string, nullable
      - `prior_evidence_source_segment_id` integer, nullable
      - `prior_source_artifact_version_id` integer, nullable
      - `prior_source_call_id` string, nullable
      - `prior_source_title` string, nullable
      - `prior_source_occurred_at` string, date-time, nullable
      - `prior_source_url` string, nullable
      - `extractor_model` string, required
      - `extractor_version` string, required
      - `extracted_at` string, date-time, required
      - `metric` string, nullable
      - `value_kind` 'qualitative' | 'point' | 'range' | 'minimum' | 'maximum'
      - `value_low` string, nullable
      - `value_high` string, nullable
      - `unit` 'currency' | 'percentage' | 'per_share' | 'count' | 'ratio' | 'other', nullable
      - `value_scale` 'ones' | 'thousand' | 'million' | 'billion' | 'trillion', nullable
      - `currency` string, nullable
      - `prior_value_kind` 'qualitative' | 'point' | 'range' | 'minimum' | 'maximum', nullable
      - `prior_value_low` string, nullable
      - `prior_value_high` string, nullable
      - `prior_unit` 'currency' | 'percentage' | 'per_share' | 'count' | 'ratio' | 'other', nullable
      - `prior_value_scale` 'ones' | 'thousand' | 'million' | 'billion' | 'trillion', nullable
      - `prior_currency` string, nullable
      - `effective_at` string, date-time, nullable
      - `published_at` string, date-time, nullable
      - `source_observed_at` string, date-time, nullable
      - `source_ingested_at` string, date-time, nullable
      - `revision_of_observation_id` integer, nullable
      - `feedback_labels` string[]
    - `outcomes` ManagementGuidanceOutcomeOut[]
      - `id` integer, required
      - `guidance_observation_id` integer, required
      - `resolution_observation_id` integer, required
      - `status` 'met' | 'missed' | 'withdrawn' | 'superseded', required
      - `statement` string, required
      - `evidence_quote` string, required
      - `source_speaker` string, nullable
      - `source_segment_id` integer, nullable
      - `source_artifact_version_id` integer, nullable
      - `source_call_id` string, required
      - `source_title` string, required
      - `source_url` string, required
      - `effective_at` string, date-time, required
      - `published_at` string, date-time, nullable
      - `source_observed_at` string, date-time, nullable
      - `source_ingested_at` string, date-time, nullable
      - `analysis_fingerprint` string, required
  - `last_analyzed_at` string, date-time, nullable, required
  - `analysis` CompanyStateAnalysisJobOut
    - `status` 'pending' | 'running' | 'complete' | 'failed', required
    - `stage` 'queued' | 'fetching_calls' | 'extracting' | 'persisting' | 'complete' | 'failed', required
    - `requested_at` string, date-time, required
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `attempt_count` integer, required
    - `observation_count` integer, required
    - `cache_hit` boolean, required
    - `error_code` 'dispatch_failed' | 'task_failed' | 'provider_access_denied' | 'insufficient_calls' | 'speaker_segments_unavailable', nullable

## Other responses

- `422`: Validation Error

---

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