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 |
JSON Schema
{
"$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.
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.