ChangeDateWindow

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentdeals-dev/json-schema/agentdeals-dev-change-date-window-schema.json",
  "title": "ChangeDateWindow",
  "description": "The date filter this response was built under, stated whether or not one ran. A count of 0 means we hold no matching record only when applied is false; when applied is true it means we hold none dated on or after from, and the same query with a wider since may answer differently. The default 30-day window runs on the unfiltered feed alone — a request naming a type, vendor, vendors or category is answered from the whole change log.",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentdeals-dev-openapi.json#/components/schemas/ChangeDateWindow",
  "type": "object",
  "properties": {
    "applied": {
      "type": "boolean",
      "description": "Whether any date filter narrowed this response."
    },
    "from": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "The earliest date a record could carry and still be returned. Null when applied is false."
    },
    "source": {
      "type": "string",
      "enum": [
        "default",
        "since_parameter",
        "none"
      ],
      "description": "'since_parameter' — your since value. 'default' — our window, because the request named no filter. 'none' — no date filter ran."
    },
    "field": {
      "type": "string",
      "enum": [
        "date"
      ],
      "description": "The record field from compares against. date is the effective date only where date_meaning is \"effective\"; where it is \"discovered\", date is the day we recorded the change; where it is \"effective_by\", date is the latest day the change can have taken effect."
    },
    "note": {
      "type": "string",
      "description": "The same statement in prose, for a caller reading the response rather than parsing it."
    }
  },
  "required": [
    "applied",
    "from",
    "source",
    "field",
    "note"
  ]
}