Last Price · Schema

PriceVerifyResponse

PricingSoftware-as-a-ServiceMarketplaceArtificial IntelligenceCompute

Properties

Name Type Description
payment object Only on a paid verdict (no credential, `x402-verify-price`). A verdict of `unknown` says `charged: false` and the payment may be used again.
top_up object 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.
request_id string
verdict string
proposed_price number
currency string
reference_price numbernull The price the evidence points at, weighted across strategies.
band objectnull The range within which the proposed price counts as within band. Null when nothing could judge the price.
deviation_pct numbernull Signed. Positive means the proposal sits above the reference.
confidence number
next_step string 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 co
next_step_reason string One sentence on why `next_step` is what it is.
valid_until string 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 integer The window `valid_until` was worked out from. Present with it.
quote_expired boolean Whether the `quote_valid_until` sent had already passed. Present only when one was sent and quote expiry is on.
quote_expired_seconds_ago integer How long ago it passed, in seconds. Present only when `quote_expired` is true.
outcome_terms object 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 n
independent_evidence boolean Whether any usable evidence was both external to you and derived without reference to `proposed_price`. Your own `constraints` do not count, even though their evidence item reports `independent_of_pro
evidence array
reasons array
price_statement object 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 v
View JSON Schema on GitHub

JSON Schema

last-price-ai-price-verify-response-schema.json Raw ↑
{
  "$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."
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/last-price-ai-price-verify-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.