{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/last-price-ai/json-schema/last-price-ai-price-verify-response-schema.json",
  "title": "PriceVerifyResponse",
  "x-generated": "2026-11-15",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/last-price-ai-openapi.json#/components/schemas/PriceVerifyResponse",
  "type": "object",
  "properties": {
    "payment": {
      "description": "Only on a paid verdict (no credential, `x402-verify-price`). A verdict of `unknown` says `charged: false` and the payment may be used again.",
      "type": "object",
      "properties": {
        "charged": {
          "type": "boolean"
        },
        "amount": {
          "type": "string",
          "description": "USDC, as a decimal."
        },
        "currency": {
          "type": "string",
          "enum": [
            "USDC"
          ]
        },
        "payment_id": {
          "type": "string"
        }
      },
      "required": [
        "charged"
      ]
    },
    "top_up": {
      "description": "Only while the workspace's prepaid balance paid for this call and is now below its enabled auto top-up threshold. An offer; nothing is charged automatically.",
      "allOf": [
        {
          "$ref": "#/$defs/BalanceTopUpHint"
        }
      ]
    },
    "request_id": {
      "type": "string",
      "format": "uuid"
    },
    "verdict": {
      "x-lastprice-term": "lp:verdict",
      "type": "string",
      "enum": [
        "within_band",
        "too_high",
        "too_low",
        "unknown"
      ]
    },
    "proposed_price": {
      "type": "number",
      "x-lastprice-term": "lp:proposed-price"
    },
    "currency": {
      "type": "string"
    },
    "reference_price": {
      "x-lastprice-term": "lp:reference-price",
      "type": [
        "number",
        "null"
      ],
      "description": "The price the evidence points at, weighted across strategies."
    },
    "band": {
      "x-lastprice-term": "lp:band.verification",
      "type": [
        "object",
        "null"
      ],
      "description": "The range within which the proposed price counts as within band.\nNull when nothing could judge the price.\n",
      "properties": {
        "lower": {
          "type": [
            "number",
            "null"
          ],
          "description": "Lower bound, or null when the band is open below."
        },
        "upper": {
          "type": [
            "number",
            "null"
          ],
          "description": "Upper bound, or null when the band is open above."
        }
      },
      "required": [
        "lower",
        "upper"
      ]
    },
    "deviation_pct": {
      "x-lastprice-term": "lp:deviation",
      "type": [
        "number",
        "null"
      ],
      "description": "Signed. Positive means the proposal sits above the reference."
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "x-lastprice-term": "lp:confidence.verdict"
    },
    "next_step": {
      "x-lastprice-term": "lp:next-step",
      "type": "string",
      "enum": [
        "buy",
        "negotiate",
        "walk_away",
        "check_more"
      ],
      "description": "What a buyer holding this price should do next. `buy`: within band at confidence 0.5 or more, on independent evidence, with a ceiling. `negotiate`: too high. `walk_away`: too high by 50% or more at confidence 0.5 or more. `check_more`: unknown, too low (often the wrong item or a mistake), or within band on weak, circular or cost-only evidence."
    },
    "next_step_reason": {
      "x-lastprice-term": "lp:next-step",
      "type": "string",
      "description": "One sentence on why `next_step` is what it is."
    },
    "valid_until": {
      "type": "string",
      "format": "date-time",
      "description": "How long this verdict holds (the window of the function it was judged with, else 15 minutes). Present only while quote expiry is on for the workspace."
    },
    "valid_for_seconds": {
      "type": "integer",
      "description": "The window `valid_until` was worked out from. Present with it."
    },
    "quote_expired": {
      "type": "boolean",
      "description": "Whether the `quote_valid_until` sent had already passed. Present only when one was sent and quote expiry is on."
    },
    "quote_expired_seconds_ago": {
      "type": "integer",
      "description": "How long ago it passed, in seconds. Present only when `quote_expired` is true."
    },
    "outcome_terms": {
      "description": "For a price charged per outcome while outcome terms are on: the stated terms, with `complete: false` when one is missing. A price with no `resolve_by` is reported incomplete instead of judged on the number alone; the verdict itself is unchanged.",
      "allOf": [
        {
          "$ref": "#/$defs/PriceOutcomeTerms"
        }
      ]
    },
    "independent_evidence": {
      "x-lastprice-term": "lp:independent-evidence",
      "type": "boolean",
      "description": "Whether any usable evidence was both external to you and derived\nwithout reference to `proposed_price`.\n\nYour own `constraints` do not count, even though their evidence item\nreports `independent_of_proposal: true` and `binding: true`. That\nflag is accurate per item: a bound you supplied is indeed not\nderived from the price under judgement. But a caller restating the\nfloor it already believes in is not a check on that belief, so it\ncannot make this top-level flag true on its own. Read\n`independent_of_proposal` as \"was this item derived from the\nproposal?\" and this field as \"was the verdict corroborated by\nanything other than you?\".\n\nWith no `context.current_price`, the reference is computed with the\nproposed price standing in for the incumbent. It counts as\nindependent only when that stand-in made no difference: the\nfunction that answered is run again with a stand-in below and\nabove the proposal, and the reference and band must come back\nunchanged. A unit cost on its own does not make a reference\nindependent, because under default routing a function that prices\nrelative to the incumbent may answer, and workspace guardrails can\nhold any function's answer near the incumbent.\n\nFalse means the verdict is partly circular: the pricing function\nwas partly reasoning from the number under judgement. Such a\nverdict should be treated as weak, and the reference's weight is\nhalved. Supply `context.current_price`, or `metadata.unit_cost`\nwith `routing_preference: explicit` and the `function_id` of\n`lastprice/cost-plus`, for an independent reference.\n"
    },
    "evidence": {
      "x-lastprice-term": "lp:evidence",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "string"
          },
          "reference_price": {
            "type": [
              "number",
              "null"
            ]
          },
          "band": {
            "x-lastprice-term": "lp:band.verification",
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "lower": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "upper": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "lower",
              "upper"
            ]
          },
          "weight": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "independent_of_proposal": {
            "type": "boolean",
            "description": "Whether this evidence was derived without using\n`proposed_price`. For `network_reference` with no\n`context.current_price`, true only when recomputing the\nreference with different stand-ins for the incumbent left it\nunchanged. See `independent_evidence` on the response.\n"
          },
          "binding": {
            "type": "boolean",
            "description": "A bound that may never be relaxed."
          },
          "informational": {
            "type": "boolean",
            "description": "Reported next to the verdict and never counted in it (weight 0, no band), so it is not discarded evidence."
          },
          "buyer_envelope": {
            "description": "On `buyer_budget` evidence only.",
            "allOf": [
              {
                "$ref": "#/$defs/BuyerSpendEnvelope"
              }
            ]
          },
          "note": {
            "type": "string"
          }
        }
      }
    },
    "reasons": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "price_statement": {
      "x-lastprice-term": "lp:price-statement",
      "description": "What this answer is: a third party's estimate for this caller, whose `band` is an acceptance range (`interval_meaning: acceptance_range`), a tolerance around `reference_price` and not an interval of value.",
      "allOf": [
        {
          "$ref": "#/$defs/PriceStatementAxes"
        },
        {
          "type": "object",
          "properties": {
            "interval_meaning": {
              "type": "string",
              "enum": [
                "acceptance_range"
              ],
              "x-lastprice-term": "lp:interval-meaning"
            }
          }
        }
      ]
    }
  },
  "$defs": {
    "BalanceTopUpHint": {
      "type": "object",
      "description": "Carried by a successful compute response while the workspace's prepaid balance is below its enabled auto top-up threshold: the exact request that tops it up by the amount the workspace chose. An offer only; nothing is charged automatically.",
      "required": [
        "reason",
        "balance",
        "threshold",
        "method",
        "path",
        "body",
        "note"
      ],
      "properties": {
        "reason": {
          "type": "string",
          "enum": [
            "balance_low"
          ]
        },
        "balance": {
          "type": "string",
          "description": "The balance after this call, in USDC."
        },
        "threshold": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "enum": [
            "USDC"
          ]
        },
        "method": {
          "type": "string",
          "enum": [
            "POST"
          ]
        },
        "path": {
          "type": "string",
          "enum": [
            "/api/billing/topup"
          ]
        },
        "body": {
          "type": "object",
          "properties": {
            "amount": {
              "type": "string"
            }
          }
        },
        "header": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      }
    },
    "BuyerSpendEnvelope": {
      "type": "object",
      "description": "What buyers' own spend checks allowed in a category, pooled across buyer workspaces. Numbers show only once 5 or more buyer workspaces have had a check allowed in it; each counts once, by its largest allowed check; the lowest and highest are pulled in to their neighbours and every amount is rounded to a coarse step, and the count is a coarse band. Below 5, `privacy_threshold_met` is false and every number, the count included, is null. A threshold, not differential privacy. A limit, not a valuation.",
      "required": [
        "category",
        "currency",
        "privacy_threshold_met",
        "contributor_band",
        "band_min",
        "typical_amount",
        "band_max",
        "over_cap_refusal_rate",
        "position",
        "band_position",
        "caveat"
      ],
      "properties": {
        "category": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "privacy_threshold_met": {
          "type": "boolean"
        },
        "contributor_band": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "5-9",
            "10-24",
            "25+",
            null
          ],
          "description": "Roughly how many buyer workspaces were pooled, never the exact count; null below 5."
        },
        "band_min": {
          "type": [
            "number",
            "null"
          ],
          "description": "p25 of the workspaces' largest allowed checks.",
          "x-lastprice-term": "lp:band.peer-spend"
        },
        "typical_amount": {
          "type": [
            "number",
            "null"
          ],
          "description": "The median."
        },
        "band_max": {
          "type": [
            "number",
            "null"
          ],
          "description": "p75.",
          "x-lastprice-term": "lp:band.peer-spend"
        },
        "over_cap_refusal_rate": {
          "type": [
            "number",
            "null"
          ],
          "minimum": 0,
          "maximum": 1,
          "description": "Share of checks refused over a per-purchase maximum, a daily cap or a category budget; null until 5 or more of the workspaces have had one."
        },
        "position": {
          "x-lastprice-term": "lp:band-position",
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "below_band",
            "inside_band",
            "above_band",
            null
          ],
          "description": "Older spelling of `band_position`, kept for callers that read it. Where the price judged, computed or checked sits against p25 to p75; null without a band."
        },
        "band_position": {
          "x-lastprice-term": "lp:band-position",
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "below",
            "inside",
            "above",
            null
          ],
          "description": "Where the price judged, computed or checked sits against p25 to p75, spelled like every other band position (the x402 market band's `position`); null without a band."
        },
        "caveat": {
          "type": "string"
        }
      }
    },
    "PriceOutcomeTerms": {
      "type": "object",
      "description": "When an outcome price counts as failed and what is owed then, as the caller stated them in `context.metadata.outcome_terms`, normalised. Terms left out are listed in `missing` and never filled in; `suggested` holds a default for each that the caller could adopt. Present only for a price charged per outcome (`metadata.unit` is `outcome`, a topology such as `outcome-based` or `pay-on-success` in `metadata.topology`, `metadata.pricing_model` or `metadata.billing_model`, terms were sent, or the function's name says outcome) while outcome terms (the `outcome-failure-terms` release flag) are on for the workspace.",
      "properties": {
        "success_definition": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 500,
          "description": "What the buyer must see for the outcome to count."
        },
        "resolve_by": {
          "type": [
            "string",
            "null"
          ],
          "description": "The deadline as stated, an ISO 8601 duration from the quote (weeks, days, hours, minutes, seconds) or an RFC 3339 time. One minute to one year away."
        },
        "resolve_by_kind": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "duration",
            "timestamp",
            null
          ]
        },
        "resolves_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "The deadline as a time in UTC. After it, with no success, the outcome has failed."
        },
        "on_timeout": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "no_charge",
            "partial",
            "full",
            null
          ],
          "description": "What is owed when the deadline passes without success."
        },
        "timeout_share": {
          "type": [
            "number",
            "null"
          ],
          "minimum": 0,
          "maximum": 1,
          "description": "The fraction of the price owed on timeout: 0 for no_charge, 1 for full."
        },
        "owed_on_timeout": {
          "type": [
            "number",
            "null"
          ],
          "description": "`timeout_share` of the price, rounded to cents."
        },
        "evidence": {
          "type": "array",
          "maxItems": 10,
          "items": {
            "type": "string"
          },
          "description": "What proves the outcome."
        },
        "complete": {
          "type": "boolean",
          "description": "True when success_definition, resolve_by and on_timeout are all stated and readable."
        },
        "missing": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "success_definition",
              "resolve_by",
              "on_timeout"
            ]
          }
        },
        "problems": {
          "type": "array",
          "description": "Terms that were stated but could not be read, and why.",
          "items": {
            "type": "object",
            "properties": {
              "field": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            }
          }
        },
        "suggested": {
          "type": "object",
          "description": "A default for each missing term. Never applied for the caller.",
          "properties": {
            "resolve_by": {
              "type": "string"
            },
            "on_timeout": {
              "type": "string",
              "enum": [
                "no_charge",
                "partial",
                "full"
              ]
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "note": {
          "type": [
            "string",
            "null"
          ],
          "description": "One sentence on what is missing; null when complete."
        }
      },
      "required": [
        "complete",
        "missing"
      ]
    },
    "PriceStatementAxes": {
      "type": "object",
      "description": "What kind of price statement an answer is (`lp:price-statement`), on the three axes every price carries. A kind of price (`kind`, `lp:price-kind`: list, floor, ceiling, offer, agreed, settled, observed, computed, quoted) is a named combination of the three, defined in the ontology at /ns/price. Always present on a priced answer; the open world rule for what is missing is in /.well-known/lastprice-vocabulary.json.",
      "required": [
        "speaker",
        "standing",
        "audience"
      ],
      "properties": {
        "speaker": {
          "type": "string",
          "enum": [
            "seller",
            "buyer",
            "both",
            "third_party",
            "market"
          ],
          "description": "Who stands behind the amount. Last Price speaks as third_party; a signed quote is the workspace speaking as seller."
        },
        "standing": {
          "type": "string",
          "enum": [
            "proposal",
            "commitment",
            "executed",
            "estimate",
            "constraint"
          ],
          "description": "What the amount commits anyone to. An estimate binds nobody; a commitment binds until valid_until; a constraint (floor, ceiling) bounds a party's own proposals and is never offered."
        },
        "audience": {
          "type": "string",
          "enum": [
            "public",
            "one_counterparty",
            "private"
          ],
          "description": "Whom the amount was addressed to. An answer to one caller is one_counterparty."
        },
        "interval_meaning": {
          "type": "string",
          "enum": [
            "credible_interval",
            "evidence_spread",
            "acceptance_range",
            "negotiation_room"
          ],
          "description": "Only on an answer that carries a band or a low and high; what its edges are."
        }
      }
    }
  }
}