---
title: "Public methodology quality metrics"
method: GET
path: "/api/v1/methodology/metrics"
---

# Public methodology quality metrics

`GET /api/v1/methodology/metrics`

## Request

- Base URL: `https://streetproof.com`
- URL: `https://streetproof.com/api/v1/methodology/metrics`
- Auth: none required

Quarterly public quality metrics for OCR measurement status, entity-match review outcomes, published-row redactions by reason, dispute timing, and city coverage confidence. Precision/recall remain not_yet_reportable until labeled holdout samples exist.

## Response `200`

Public methodology metrics report.

- MethodologyMetricsReport
  - `schema` 'com.streetproof.public_methodology_metrics.v1'
  - `generated_at` string, date-time
  - `reporting_window` object
  - `urls` object
  - `summary` object
    - `verified_observations` integer, nullable: Deprecated 2026-07-28; remove after 2026-10-27. Legacy synthetic-scope count. Use strictly_verified_observations for formal verification in the production public scope.
    - `strictly_verified_observations` integer, nullable: Production, non-synthetic public observations in the formal verified state.
  - `metric_snapshot` MetricSnapshot
    - `snapshot_id` string, uuid, nullable, required
    - `scope` 'live_ledger', required
    - `data_as_of` string, date-time, required
    - `calculated_at` string, date-time, required
    - `snapshot_type` 'live_ledger', required
    - `metric_scope` 'multi_scope_snapshot', required: This receipt contains metrics from multiple explicitly named scopes; inspect scopes and scope_definitions before using a field.
    - `includes_synthetic` true, required: At least one field in this multi-scope receipt can include labeled synthetic demonstration data. Production-only fields remain identified by their scope.
    - `methodology_version` 'public-metrics-v3', required
    - `scopes` string[], required
    - `scope_definitions` object, required
      - `production_non_synthetic` 'Accepted public physical citations and related counts with synthetic records excluded.', required
      - `public_including_synthetic` 'All public observations, including clearly labeled synthetic demonstration records.', required
      - `ledger_all_rows` 'All ledger rows, including provisional, redacted, rejected, and non-public records.', required
  - `coverage_snapshot` CoverageSnapshot
    - `snapshot_id` string, uuid, nullable, required
    - `scope` 'coverage_snapshot', required
    - `data_as_of` string, date-time, nullable, required
    - `calculated_at` string, date-time, nullable, required
    - `snapshot_type` 'coverage_snapshot', required
    - `metric_scope` 'production_non_synthetic', required
    - `includes_synthetic` false, required
    - `methodology_version` string, nullable, required
    - `evaluated_city_count` integer, required
    - `city_catalog_count` integer, required
    - `cities_with_evidence` integer, required
    - `coverage_tiers` object, required
      - `seed` integer, required
      - `building` integer, required
      - `dense` integer, required
      - `pending_calculation` integer, required
  - `deprecated_fields` object
  - `headline_metrics` MethodologyMetric[]
    - `key` string
    - `label` string
    - `value` number, nullable
    - `unit` 'percent' | 'count' | 'hours' | 'ratio'
    - `sample_size` integer
    - `status` 'reportable' | 'directional' | 'not_yet_reportable'
    - `note` string
  - `ocr_sample` object
  - `entity_match_sample` object
  - `dispute_metrics` object
  - `coverage_by_city` object[]
    - `city_slug` string
    - `city_name` string
    - `observed_cells` integer
    - `public_observations` integer
    - `public_entities` integer
    - `latest_observed_at` string, date-time, nullable
    - `confidence_level` 'none' | 'low' | 'medium' | 'high'
    - `confidence_note` string
  - `limitations` string[]

---

[API](https://skmtc.dev/streetproof/apis/streetproof-physical-brand-index-api.md) · [All operations](https://skmtc.dev/streetproof/apis/streetproof-physical-brand-index-api/llms.txt) · [OpenAPI document](https://skmtc.dev/streetproof/apis/streetproof-physical-brand-index-api/revisions/81072718cfa2?raw)