---
title: "Ai Quality Observability"
method: GET
path: "/admin/quality/observability"
tags: ["launch admin"]
---

# Ai Quality Observability

`GET /admin/quality/observability`

## 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/admin/quality/observability`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Return the existing content-free AIOBS report without starting AI work.

## Query parameters

- `since_days` integer

## Response `200`

Successful Response

- AIQualityObservabilityOut
  - `features` object, required
  - `workflows` object, required
  - `replay` ReplayDiagnosticsOut, required
    - `eligible_terminal_runs` integer, required
    - `observed_terminal_runs` integer, required
    - `legacy_untraced_jobs` integer, required
    - `queued_jobs` integer, required
    - `running_jobs` integer, required
    - `stalled_jobs` integer, required
    - `recent_executions` ReplayExecutionDiagnosticOut[], required
      - `trace_id` string, required
      - `job_id` integer, required
      - `requested_at` string, date-time, required
      - `finished_at` string, date-time, nullable, required
      - `evaluator_version` string, required
      - `window_days` 90 | 365, required
      - `status` 'pending' | 'running' | 'complete' | 'failed', required
      - `candidate_count` integer, required
      - `completed_count` integer, required
      - `created_count` integer, required
      - `retry_count` integer, required
      - `error_code` string, nullable, required
      - `observed` boolean, required
      - `input_identity_sha256` string, nullable, required
      - `source_identity_sha256` string, nullable, required
      - `output_identity_sha256` string, nullable, required
      - `queue_wait_ms` integer, nullable, required
      - `elapsed_ms` integer, nullable, required
      - `usage_event_count` integer, required
      - `estimated_cost_usd` string, nullable, required
  - `schema_version` 'ai-quality-observability-coverage/v5', required
  - `since` string, date-time, required
  - `captured_at` string, date-time, required
  - `observed_release_sha` string, nullable, required
  - `surfaces` AIQualitySurfacesOut, required
    - `match` AIQualitySurfaceCoverageOut, required
      - `eligible_terminal_runs` integer, required
      - `observed_terminal_runs` integer, required
      - `coverage_percent` number, nullable
      - `status` 'not_applicable_no_eligible_runs' | 'missing' | 'partial' | 'pass', required
    - `morning_brief` AIQualitySurfaceCoverageOut, required
      - `eligible_terminal_runs` integer, required
      - `observed_terminal_runs` integer, required
      - `coverage_percent` number, nullable
      - `status` 'not_applicable_no_eligible_runs' | 'missing' | 'partial' | 'pass', required
    - `historical_replay` AIQualitySurfaceCoverageOut, required
      - `eligible_terminal_runs` integer, required
      - `observed_terminal_runs` integer, required
      - `coverage_percent` number, nullable
      - `status` 'not_applicable_no_eligible_runs' | 'missing' | 'partial' | 'pass', required
  - `observation_count` integer, required
  - `observations_with_usage` integer, required
  - `observations_without_usage` integer, required
  - `zero_work_observations_without_usage` integer, required
  - `unexpected_observations_without_usage` integer, required
  - `invalid_or_redaction_contract_observations` integer, required
  - `usage` AIQualityUsageOut, required
    - `event_count` integer, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `cache_read_tokens` integer, required
    - `cache_write_tokens` integer, required
    - `estimated_cost_usd` string, nullable, required
    - `unpriced_event_count` integer, required
    - `by_operation_and_model` AIQualityUsageBreakdownOut[], required
      - `operation` string, required
      - `model` string, required
      - `event_count` integer, required
      - `input_tokens` integer, required
      - `output_tokens` integer, required
      - `cache_read_tokens` integer, required
      - `cache_write_tokens` integer, required
      - `estimated_cost_usd` string, nullable, required
      - `unpriced_event_count` integer, required
  - `latency_ms` AIQualityLatenciesOut, required
    - `overall` AIQualityLatencySummaryOut, required
      - `count` integer, required
      - `min` integer, nullable
      - `p50` integer, nullable
      - `p95` integer, nullable
      - `max` integer, nullable
    - `by_surface` AIQualitySurfaceLatenciesOut, required
      - `match` AIQualityLatencySummaryOut, required
        - `count` integer, required
        - `min` integer, nullable
        - `p50` integer, nullable
        - `p95` integer, nullable
        - `max` integer, nullable
      - `morning_brief` AIQualityLatencySummaryOut, required
        - `count` integer, required
        - `min` integer, nullable
        - `p50` integer, nullable
        - `p95` integer, nullable
        - `max` integer, nullable
      - `historical_replay` AIQualityLatencySummaryOut, required
        - `count` integer, required
        - `min` integer, nullable
        - `p50` integer, nullable
        - `p95` integer, nullable
        - `max` integer, nullable
  - `outcomes` AIQualityOutcomesOut, required
    - `match` AIQualitySurfaceOutcomesOut, required
      - `metrics` object, required
      - `failure_classes` object, required
    - `morning_brief` AIQualitySurfaceOutcomesOut, required
      - `metrics` object, required
      - `failure_classes` object, required
    - `historical_replay` AIQualitySurfaceOutcomesOut, required
      - `metrics` object, required
      - `failure_classes` object, required
  - `content_retained` false, required
  - `reporter_provider_or_model_calls` 0, required

## 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)