{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/africanmarketos-com/json-schema/africanmarketos-com-utility-market-scope-schema.json",
  "title": "UtilityMarketScope",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/africanmarketos-com-benchmark-context-api-openapi.yml#/components/schemas/UtilityMarketScope",
  "type": "object",
  "properties": {
    "country": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "district": {
      "type": "string",
      "pattern": "\\S"
    },
    "districts": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "\\S"
      }
    },
    "decision_scope_level": {
      "type": "string",
      "enum": [
        "country",
        "subnational"
      ],
      "description": "Explicit decision extent. Alternatively supply district(s). Subnational scope also requires local geography. Do not relabel or widen the decision to pass."
    },
    "town_or_zone": {
      "type": "string"
    },
    "micro_context": {
      "type": "string"
    },
    "corridor": {
      "type": "string"
    },
    "sector": {
      "type": "string"
    },
    "analysis_date": {
      "type": "string"
    },
    "geo_match_tolerance": {
      "type": "string",
      "enum": [
        "strict",
        "same_city",
        "region",
        "country"
      ],
      "default": "strict",
      "description": "Declare the actual decision geography. Do not widen it to obtain a verdict."
    }
  },
  "additionalProperties": true
}