--- title: "Citable public evidence packet" method: GET path: "/api/v1/entity/{public_id}/evidence" --- # Citable public evidence packet `GET /api/v1/entity/{public_id}/evidence` ## Request - Base URL: `https://streetproof.com` - URL: `https://streetproof.com/api/v1/entity/{public_id}/evidence` - Auth: none required Returns public summary facts, normalized asset and observation metadata, citations, and coverage context. Storage keys, raw evidence URLs, exact addresses, phone numbers, redacted observations, and opted-out entities are excluded. ## Path parameters - `public_id` string, required ## Response `200` Public evidence packet - PublicEvidencePacket - `schema` 'com.streetproof.public_evidence_packet.v2', required - `generated_at` string, date-time, required - `license` string - `record` object, required - `public_id` string - `name` string - `city` string, nullable - `city_name` string, nullable - `industry` string, nullable - `record_status` 'active' | 'dissolved' - `identity_status` 'unclaimed' | 'claimed' | 'identity_verified' - `status` string: Deprecated 2026-07-29; remove after 2026-10-27. Use record_status and identity_status. - `is_synthetic` boolean - `first_observed` string, date-time, nullable - `last_observed` string, date-time, nullable - `urls` object - `what_this_proves` string[], required - `what_this_does_not_prove` string[], required - `score` object - `pps_current` number, nullable - `provisional_pps` number, nullable - `score_state` 'official' | 'provisional' | 'pending' - `ranking_state` 'insufficient_evidence' | 'eligible' | 'frozen' - `ranking_reason` string, nullable - `independent_observer_count` integer - `independent_observation_count` integer - `observation_day_count` integer - `ranking_gate` RankingGate - `status` 'eligible' | 'evidence_building' | 'integrity_review', required - `methodology_version` '2026-07-30.v3', required - `independent_observers` RankingGateProgress, required - `current` integer, required - `required` integer, required - `met` boolean, required - `countable_observations` RankingGateProgress, required - `current` integer, required - `required` integer, required - `met` boolean, required - `observation_days` RankingGateProgress, required - `current` integer, required - `required` integer, required - `met` boolean, required - `industry_classification` object, required - `industry` string, nullable, required - `state` string, nullable, required - `method` string, nullable, required - `authoritative_for_ranking` boolean, required - `missing_requirements` string[], required - `observations` object, required - `total_public` integer - `unique_assets` integer - `unique_cells` integer - `source_mix` object[] - `verification_mix` object[] - `presence_mix` object[] - `recent` object[]: Public metadata only; object-storage keys and raw evidence URLs are excluded. - `id` integer - `asset_public_id` string, nullable - `asset_type` string, nullable - `presence_kind` 'location_presence' | 'mobile_presence' | 'brand_mention' - `ledger_schema_version` 1 | 2 - `source_type` string - `observed_at` string, date-time, nullable - `h3_cell` string - `observation_verification_state` string - `verif_state` string: Deprecated 2026-07-29; remove after 2026-10-27. Use observation_verification_state. - `trust_weight` number - `detect_conf` number, nullable - `ocr_conf` number, nullable - `ledger_hash` string - `redaction_request_count` integer - `latest_redaction_state` string, nullable - `assets` Asset[], required - `public_id` string - `asset_type` 'vehicle_wrap' | 'storefront' | 'billboard' | 'site_sign' | 'temp_sign' - `is_mobile` boolean - `legibility_score` number, nullable - `first_observed` string, date-time, nullable - `last_observed` string, date-time, nullable - `status` 'active' | 'stale' | 'retired' - `observation_count` integer - `citations` object, required - `methodology_url` string, uri - `data_as_of` string, date-time: Server-authoritative timestamp. - `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 - `evidence_claim_boundary` EvidenceClaimBoundary, required - `schema` 'com.streetproof.evidence_claim_boundary.v1', required - `contract_version` string, required - `positive_result` object, required - `summary` string, required - `presence_kinds` object, required - `location_presence` string, required - `mobile_presence` string, required - `brand_mention` string, required - `no_result` object, required - `meaning` string, required - `limitation` string, required - `what_this_proves` string[], required - `what_this_does_not_prove` string[], required - `coverage_confidence` CoverageConfidence: Versioned per-city dataset maturity. Coverage never changes the evidence standard for an individual citation. A missing record never proves a business is not operating. - `level` 'none' | 'low' | 'medium' | 'high' - `tier` 'unlaunched' | 'seed' | 'building' | 'dense' | 'null', nullable - `freshness` 'current' | 'aging' | 'stale' | 'null', nullable: Null when the city is unlaunched because freshness does not apply. - `observed_cells` integer - `methodology_version` string - `calculated_at` string, date-time, nullable - `limitations` string - `note` string - `coverage_context` CoverageContext: Versioned city dataset maturity and freshness. It does not change individual-citation evidence requirements, and a missing record never proves absence. - `tier` 'unlaunched' | 'seed' | 'building' | 'dense' | 'null', nullable - `label` string - `freshness` 'current' | 'aging' | 'stale' | 'null', nullable: Null when the city is unlaunched because freshness does not apply. - `confidence` 'none' | 'low' | 'medium' | 'high' - `tier_since` string, date, nullable - `calculated_at` string, date-time, nullable - `methodology_version` string - `limitations` string - `metrics` object ## Other responses - `404`: Resource not found (or entity opted out). --- [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)