NearbyLocalPrices

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/shelfatlas-com/json-schema/shelfatlas-com-nearby-local-prices-schema.json",
  "title": "NearbyLocalPrices",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/shelfatlas-com-openapi.json#/components/schemas/NearbyLocalPrices",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "items",
    "summary"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "ean",
          "label",
          "priceCents",
          "stockStatus",
          "observedAt",
          "trust",
          "store",
          "distanceKm"
        ],
        "properties": {
          "ean": {
            "type": "string"
          },
          "label": {
            "type": [
              "string",
              "null"
            ],
            "description": "Curated product name, or null when the ean is not a known product."
          },
          "priceCents": {
            "type": "integer",
            "description": "Shelf price in øre (DKK×100) as observed."
          },
          "stockStatus": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "in_stock",
              "low_stock",
              "out_of_stock",
              null
            ]
          },
          "observedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the shelf was seen — a raw fact, no server-computed age."
          },
          "trust": {
            "type": "string",
            "enum": [
              "partner",
              "established",
              "new"
            ],
            "description": "Source class — never the reporter identity."
          },
          "store": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "name",
              "chainSlug",
              "chainName"
            ],
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "name": {
                "type": "string"
              },
              "chainSlug": {
                "type": "string"
              },
              "chainName": {
                "type": "string"
              }
            }
          },
          "distanceKm": {
            "type": "number",
            "description": "Great-circle distance from lat/lng, rounded to 0.1 km."
          }
        }
      }
    },
    "summary": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "today",
        "week"
      ],
      "description": "Same-radius proof-line counts (design 2026-09-23 §1, §2 layer 5).",
      "properties": {
        "today": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "prices",
            "stores"
          ],
          "description": "Since local Copenhagen midnight.",
          "properties": {
            "prices": {
              "type": "integer"
            },
            "stores": {
              "type": "integer",
              "description": "Distinct stores with at least one price seen today."
            }
          }
        },
        "week": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "prices",
            "contributors"
          ],
          "description": "Rolling last 7 days.",
          "properties": {
            "prices": {
              "type": "integer"
            },
            "contributors": {
              "type": "integer",
              "description": "Distinct contributors (count only — never a reporter id)."
            }
          }
        }
      }
    }
  }
}