---
title: "City list with versioned coverage context (bare array for Scout app compatibility)"
method: GET
path: "/api/v1/cities"
---

# City list with versioned coverage context (bare array for Scout app compatibility)

`GET /api/v1/cities`

## Request

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

## Query parameters

- `scope` 'all' | 'published'

## Response `200`

Cities

- object[]
  - `id` integer
  - `slug` string
  - `name` string
  - `region` string, nullable
  - `region_code` string, nullable
  - `country` string
  - `country_name` string
  - `geoname_id` integer, nullable
  - `display_label` string
  - `publication_status` 'published' | 'unpublished'
  - `collection_status` 'active' | 'onboarding' | 'blocked' | 'not_started'
  - `data_available` boolean
  - `public_index_url` string, nullable
  - `launched` boolean: Compatibility alias for publication_status=published.
  - `evidence_claim_boundary` EvidenceClaimBoundary
    - `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` 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

---

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