SourceCheck

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentdeals-dev/json-schema/agentdeals-dev-source-check-schema.json",
  "title": "SourceCheck",
  "description": "What we found on the page at url when we last read it, and so how much of this record that page supports. The outcome grades our evidence, not the offer (#1268).",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentdeals-dev-openapi.json#/components/schemas/SourceCheck",
  "type": [
    "object",
    "null"
  ],
  "properties": {
    "checked": {
      "type": "string",
      "format": "date",
      "description": "The day we last read the page."
    },
    "outcome": {
      "type": "string",
      "enum": [
        "ok",
        "states_a_free_price",
        "states_no_amount",
        "does_not_name_vendor",
        "does_not_name_product",
        "states_no_terms",
        "unreadable"
      ],
      "description": "ok — the page names the vendor and states at least one amount, rate or price, either in figures the page renders or as a typed price in its schema.org markup (#1279). states_a_free_price — the page names the vendor and states its price in words rather than as a figure, in a phrase such as \"Free forever\" or \"free plan\" (#1668). The price is confirmed; the quantities in description come from our own entry, not from that page. states_no_amount — the page names the vendor and names a plan or tier, but every price signal on it is a phrase such as \"Enterprise plan\" that withholds that plan's price, and none is a figure (#1268). The quantities in description come from our own entry, not from that page. risk_level is still published and the summary says so, rather than being withheld. does_not_name_vendor — the page we read never writes the vendor's name. The URL we asked for is not evidence for this check, so a domain that keeps the vendor's name and loses its product reaches this outcome too (#1355). does_not_name_product — the page we read writes the platform token the vendor name shares with the host we cite it from, and never writes the rest of the name. For a vendor called <Platform> <Product> this is a live page on the platform's own domain that says nothing about the product, so the record rests on the platform existing rather than on the offer existing (#1500). states_no_terms — the page names the vendor but carries no price signal of any kind. unreadable — the fetch produced no body we could read. The last four withhold a favourable risk_level; the first three do not."
    },
    "detail": {
      "type": "string",
      "description": "Our own sentence recording what the check found — never a quotation from the page, and not corroborable against it (#1467). For ok, the form of the vendor's name the check matched and the figures the page states that this record also publishes — a stated price of zero where none of them does, and a sentence saying we matched none of the amounts we read to the terms this record publishes where the page states amounts and none of them matched (#1871, #1874) — a statement about our own reading, never about what the page contains — or what the markup states when the rendered page states no amount; for states_a_free_price and states_no_amount, the phrase that was the page's entire price evidence; otherwise why the page cannot confirm the record. Where the page was read for schema.org markup, the detail says whether that markup was absent, present and priceless, or priced. The fields carrying text taken from a page are product_role.source_quote and product_subtypes.labels[].source_quote."
    },
    "read": {
      "type": "string",
      "enum": [
        "markup"
      ],
      "description": "Present when the ok grade rests on typed prices in the page's schema.org markup rather than on a figure the page renders (#1279)."
    },
    "unrendered_prices": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Non-zero prices the page publishes as schema.org Offer data but does not render in its text — a tab or toggle layout showing one tier at a time. At most the first six are listed. The record is not written from these; they are recorded so a disagreement between markup and page can be reviewed (#1279)."
    }
  },
  "required": [
    "checked",
    "outcome",
    "detail"
  ]
}