Properties
| Name | Type | Description |
|---|---|---|
| quoteId | string | Opaque id that binds this payment-required quote to the exact request, delegation, selected rail and fee-inclusive amount. Pass it as quoteId on /route before expiresAt. |
| expiresAt | string | ISO-8601 expiry of quoteId. Present with quoteId; after this instant the call must be quoted again. |
| paymentRequired | boolean | Whether the upstream asked for payment (answered 402). `false` means the call is free, or the upstream answered with an error before any payment challenge: read `upstreamStatus`, and expect every pric |
| upstreamStatus | number | The status the upstream answered the unpaid probe with — 402 when `paymentRequired` is true. The upstream body and headers are never returned. |
| optionSet | string | Which set of payment options was priced. `delegation`: the options the supplied `delegationId` would select. `deployment`: no delegation was supplied, so the options a personal crypto (erc4337) delega |
| delegationId | stringnull | The delegation whose options were priced, or null for the `deployment` option set. Present when `paymentRequired` is true. |
| protocol | string | The payment protocol the Router would pay with — the same auto-detection as `/route` (MPP first, then x402; on the crypto rail, a 402 offering both rails whose MPP challenge's terms the Router does no |
| x402Version | number | The x402 version that would be used, on the x402 rail. |
| settlement | object | What the payment would pay the merchant: the rail (`scheme`), `network`, `asset`, the merchant leg in atomic units (`amount`) and in cents (`approxCents`). The same descriptor `/route` returns as `pay |
| fee | object | The Router fee and the fee-inclusive total the payment would reserve against the delegation cap — `capChargedMicros` exactly, `capChargedCents` rounded up to a whole cent, which is the figure `maxTota |
| sessionDeposit | object | What the call would move into a deposit, when the merchant is paid over an MPP `session` (`settlement.scheme` is `session`): a one-way payment channel whose deposit leaves the wallet at the first call |
| priceSource | string | Where the price came from. `live`: the upstream was probed for this quote, as `/route` probes it. |
| wouldSucceed | boolean | Whether the call, made now with this request and delegation, would pass every limit the quote could read: the delegation’s status and cap, `maxTotalCents`, the wallet balance on an MPP-tempo `charge`, |
| blockers | array | Why the call would be refused, in the order the call checks: the first entry is the error the call would answer with. A limit is listed once, at its first refusal (on an MPP `session`, a channel the m |
| unchecked | array | The checks the call makes that the quote tried to read and could not: a chain, ledger or database read that failed or timed out, no stored payer wallet, an MPP session’s payment channel the quote cann |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/nevermined-app/json-schema/nevermined-app-quote-result-dto-schema.json",
"title": "QuoteResultDto",
"x-generated": "2026-11-20",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/nevermined-app-openapi.json#/components/schemas/QuoteResultDto",
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"description": "Opaque id that binds this payment-required quote to the exact request, delegation, selected rail and fee-inclusive amount. Pass it as quoteId on /route before expiresAt."
},
"expiresAt": {
"type": "string",
"description": "ISO-8601 expiry of quoteId. Present with quoteId; after this instant the call must be quoted again."
},
"paymentRequired": {
"type": "boolean",
"description": "Whether the upstream asked for payment (answered 402). `false` means the call is free, or the upstream answered with an error before any payment challenge: read `upstreamStatus`, and expect every priced field below to be absent."
},
"upstreamStatus": {
"type": "number",
"description": "The status the upstream answered the unpaid probe with — 402 when `paymentRequired` is true. The upstream body and headers are never returned."
},
"optionSet": {
"type": "string",
"description": "Which set of payment options was priced. `delegation`: the options the supplied `delegationId` would select. `deployment`: no delegation was supplied, so the options a personal crypto (erc4337) delegation would select on this deployment. Present when `paymentRequired` is true.",
"enum": [
"delegation",
"deployment"
]
},
"delegationId": {
"type": [
"string",
"null"
],
"description": "The delegation whose options were priced, or null for the `deployment` option set. Present when `paymentRequired` is true."
},
"protocol": {
"type": "string",
"description": "The payment protocol the Router would pay with — the same auto-detection as `/route` (MPP first, then x402; on the crypto rail, a 402 offering both rails whose MPP challenge's terms the Router does not accept — an unsupported method, intent or term — or that the paying wallet cannot sign — an MPP `evm` charge for an EIP-7702 wallet — is quoted on its x402 offer), or exactly the rail pinned with `requireProtocol` when that is set. Present when `paymentRequired` is true.",
"enum": [
"x402",
"mpp"
]
},
"x402Version": {
"type": "number",
"description": "The x402 version that would be used, on the x402 rail."
},
"settlement": {
"description": "What the payment would pay the merchant: the rail (`scheme`), `network`, `asset`, the merchant leg in atomic units (`amount`) and in cents (`approxCents`). The same descriptor `/route` returns as `payment.settlement`. Present when `paymentRequired` is true.",
"allOf": [
{
"$ref": "#/$defs/SettlementDescriptorDto"
}
]
},
"fee": {
"description": "The Router fee and the fee-inclusive total the payment would reserve against the delegation cap — `capChargedMicros` exactly, `capChargedCents` rounded up to a whole cent, which is the figure `maxTotalCents` is compared against. The same object `/route` returns as `payment.fee`. Present when `paymentRequired` is true.",
"allOf": [
{
"$ref": "#/$defs/RouterFeeDto"
}
]
},
"sessionDeposit": {
"description": "What the call would move into a deposit, when the merchant is paid over an MPP `session` (`settlement.scheme` is `session`): a one-way payment channel whose deposit leaves the wallet at the first call, however small the call, and pays for the calls out of it. Absent on every other rail.",
"allOf": [
{
"$ref": "#/$defs/SessionDepositQuoteDto"
}
]
},
"priceSource": {
"type": "string",
"description": "Where the price came from. `live`: the upstream was probed for this quote, as `/route` probes it.",
"enum": [
"live"
]
},
"wouldSucceed": {
"type": "boolean",
"description": "Whether the call, made now with this request and delegation, would pass every limit the quote could read: the delegation’s status and cap, `maxTotalCents`, the wallet balance on an MPP-tempo `charge`, an organization wallet’s group budget, and on an MPP `session` the channel and the wallet, cap and deposit-ceiling bounds of its deposit. `true` exactly when `blockers` is empty: a check that could not be read is listed in `unchecked` and does not block, and the call still makes it. A call outside the payer’s allowed-services list is not priced: the quote refuses it as `/route` does (`BCK.SUBSCRIPTION_ROUTER.0029`, or `0030` for an organization wallet’s list), or `BCK.SUBSCRIPTION_ROUTER.0018` (503) when it cannot read the list, before the service is contacted, except a free result poll, which is checked only once the service asks payment for it. Not evaluated at all, so `true` does not rule them out: a card decline or a 3-D Secure challenge (known only by charging the card). On an organization wallet’s session the channel and its bounds are never read (`unchecked`). Advisory: nothing is reserved, so a concurrent call or a price change can still refuse the call, which checks everything again. Present when a delegation was priced (`optionSet` is `delegation`), and when `paymentRequired` is false, where it is always `true`; absent for the `deployment` option set."
},
"blockers": {
"description": "Why the call would be refused, in the order the call checks: the first entry is the error the call would answer with. A limit is listed once, at its first refusal (on an MPP `session`, a channel the merchant reports and the deposit ceiling are both `session_channel`). Empty when `wouldSucceed` is true. On an organization wallet an entry states only its `code`, `limit` and `level`, and the `delegation_cap` entry of an MPP `session`’s deposit carries no `remaining` or `required`, since the deposit is counted in the token’s units rather than the call’s cents. Present with `wouldSucceed`.",
"type": "array",
"items": {
"$ref": "#/$defs/QuoteBlockerDto"
}
},
"unchecked": {
"description": "The checks the call makes that the quote tried to read and could not: a chain, ledger or database read that failed or timed out, no stored payer wallet, an MPP session’s payment channel the quote cannot read (an organization wallet’s, or one whose read failed) with the deposit bounds that depend on it, or one with a top-up in flight, which the call refuses as busy until it resolves, or the treasury float of a call paid over an MPP session, which depends on that channel. They did not count against `wouldSucceed`: the call still makes them, and may be refused by one. Empty when every check the quote makes was read. A check the quote does not make at all is never listed here: the `wouldSucceed` description names those. Present with `wouldSucceed`.",
"type": "array",
"items": {
"$ref": "#/$defs/QuoteUncheckedDto"
}
}
},
"required": [
"paymentRequired",
"upstreamStatus",
"priceSource"
],
"$defs": {
"QuoteBlockerDto": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "The error code the call would be refused with."
},
"limit": {
"type": "string",
"description": "Which limit refuses the call. The set may grow: treat a value you do not know as a generic refusal.",
"enum": [
"delegation_status",
"delegation_cap",
"wallet_balance",
"group_budget",
"max_total",
"session_channel",
"per_call",
"daily",
"monthly",
"connection_daily",
"member_daily",
"credits_balance",
"max_credits",
"treasury"
]
},
"level": {
"type": "string",
"description": "Whose limit it is. The set may grow: treat a value you do not know as a generic refusal.",
"enum": [
"request",
"delegation",
"wallet",
"personal",
"connection",
"organization",
"member",
"nevermined"
]
},
"remaining": {
"description": "What is left under the limit.",
"allOf": [
{
"$ref": "#/$defs/QuoteFigureDto"
}
]
},
"required": {
"description": "What the call needs.",
"allOf": [
{
"$ref": "#/$defs/QuoteFigureDto"
}
]
},
"resetsAt": {
"type": "string",
"description": "When the limit next resets, as an ISO 8601 timestamp."
},
"manageUrl": {
"type": "string",
"description": "A page where the holder can change the limit."
}
},
"required": [
"code",
"limit",
"level"
]
},
"QuoteFigureDto": {
"type": "object",
"properties": {
"cents": {
"type": "string",
"description": "Whole cents of the delegation’s currency, as a decimal string. Set for a card or wallet limit; absent when `credits` is set.",
"pattern": "^(0|[1-9][0-9]*)$"
},
"credits": {
"type": "integer",
"description": "A credit count. Set for a credit limit; absent when `cents` is set.",
"minimum": 0
}
}
},
"QuoteUncheckedDto": {
"type": "object",
"properties": {
"limit": {
"type": "string",
"description": "Which check could not be read. The set may grow: treat a value you do not know as a check that was not read.",
"enum": [
"session_channel",
"delegation_cap",
"wallet_balance",
"group_budget",
"treasury",
"credits_balance"
]
},
"level": {
"type": "string",
"description": "Whose check it is. The set may grow: treat a value you do not know as a check that was not read.",
"enum": [
"request",
"delegation",
"wallet",
"personal",
"connection",
"organization",
"member",
"nevermined"
]
}
},
"required": [
"limit",
"level"
]
},
"RouterFeeDto": {
"type": "object",
"properties": {
"bps": {
"type": "number",
"description": "Rate applied to this payment, in basis points over a 10,000 denominator (e.g. `200` = 2%). `0` means no routing fee was charged."
},
"amount": {
"type": "string",
"description": "The fee in the settlement asset’s smallest unit — the same unit as `settlement.amount`. Reported atomically rather than in cents because cents are ceiling-rounded and cannot express a sub-cent fee."
},
"cents": {
"type": "string",
"description": "Cents this fee added to the delegation-cap reserve, i.e. `capChargedCents - settlement.approxCents`."
},
"capChargedCents": {
"type": "string",
"description": "The delegation-cap debit for this payment (merchant leg + routing fee), rounded UP to a whole cent. The cap itself accrues at sub-cent resolution, so the exact debit is `capChargedMicros`; this figure is the per-call price guard that `maxTotalCents` is compared against. Do not sum per-call cents for reconciliation: they ceil each call, whereas aggregate cents are derived by rounding `spentMicros` from `GET /api/v1/router/delegations/{id}` up once (ceil(spentMicros / 10000)). Use micros instead."
},
"capChargedMicros": {
"type": "string",
"description": "The exact delegation-cap debit for this payment (merchant leg + routing fee), in micros — millionths of the currency unit, i.e. 1/10,000 of a cent. It is a ceiling of the true price at that resolution, never below it. It is the debit AT MINT: if the routing fee or the merchant leg is later found uncollected, that part is given back to the cap while this figure stays as minted."
}
},
"required": [
"bps",
"amount",
"cents",
"capChargedCents",
"capChargedMicros"
]
},
"SessionDepositQuoteDto": {
"type": "object",
"properties": {
"action": {
"type": [
"string",
"null"
],
"description": "What the call would do to your payment channel with this merchant. `open`: you hold none, so this call opens one and locks a deposit. `top_up`: yours cannot cover this call, so it locks more. `none`: yours covers it, so no new money leaves the wallet. `closing`: the call would be refused (409 BCK.ROUTER.0042) and nothing moves, because the channel is closing or already holds all it may; quote again once it has closed. `null`: what the call would do cannot be stated, because the channel could not be read, the wallet is an organization’s, a top-up is already in flight, or the merchant reports a channel the Router has no record of; `amount` is then only a bound, and the last two the payment refuses.",
"enum": [
"open",
"top_up",
"none",
"closing"
]
},
"amount": {
"type": "string",
"description": "How much of `settlement.asset` this call would move from the wallet into the channel, in atomic units. The price is paid out of this deposit, not beside it. It is locked, not spent, and it is not charged to the delegation cap; what the merchant does not take comes back when the channel closes. `0` when no new money leaves the wallet. Excludes the network fee, which the wallet pays unless the merchant sponsors it.",
"pattern": "^(0|[1-9][0-9]*)$"
},
"approxCents": {
"type": "string",
"description": "`amount` in USD cents, rounded up. Tempo stablecoins are USD-pegged.",
"pattern": "^(0|[1-9][0-9]*)$"
},
"basis": {
"type": "string",
"description": "How far to take `amount` at its word. `sized`: what the call would lock with the delegation cap and wallet balance as they stand now; a concurrent call or a balance change can still move it. `upper_bound`: the most it could lock, because the cap or the balance could not be applied: no `delegationId` was given, the wallet is an organization’s, a read failed, or one of them cannot cover the call, which the payment then refuses.",
"enum": [
"sized",
"upper_bound"
]
},
"idleCloseSeconds": {
"type": "integer",
"description": "The channel closes after this many seconds without a call, and what the merchant has not taken is refunded to the wallet then. A merchant that does not cooperate adds the escrow’s own grace period to that."
}
},
"required": [
"action",
"amount",
"approxCents",
"basis",
"idleCloseSeconds"
]
},
"SettlementDescriptorDto": {
"type": "object",
"properties": {
"recipient": {
"type": "string",
"description": "The on-chain recipient (the agent’s `payTo` address from its 402)."
},
"amount": {
"type": "string",
"description": "Amount in the asset’s smallest unit (USDC/EURC = 6 decimals)."
},
"asset": {
"type": "string",
"description": "For x402 and an MPP `evm` charge the asset symbol (`USDC`/`EURC`); for MPP-tempo the payment token contract address (that rail carries no on-wire symbol); for MPP-stripe the ISO currency code."
},
"network": {
"type": "string",
"description": "Network the payment settles on (name or CAIP-2)."
},
"approxCents": {
"type": "string",
"description": "The MERCHANT leg in cents (rounded up) — what this credential pays the upstream agent. This is not necessarily the whole cap charge: Nevermined’s routing fee is reserved on top, so the whole-cent total debited from the delegation is `approxCents + fee.cents` (also reported directly as `fee.capChargedCents`; the exact sub-cent debit is `fee.capChargedMicros`). With no fee configured the two are equal."
},
"scheme": {
"type": "string",
"description": "Ledger settlement scheme: `exact` for an EIP-3009 authorization — x402, and an MPP `method=\"evm\"` charge (protocol `mpp`, settled on Base exactly like x402) — `charge` for MPP-tempo (a native Tempo transaction), `session` for an MPP-tempo payment channel (a cumulative voucher; its money moves when the service settles or closes the channel, so the payment carries no transaction hash of its own), `spt` for MPP-stripe (a Shared Payment Token). Omitted (defaults to `exact`) on the x402 path.",
"enum": [
"exact",
"charge",
"session",
"spt"
]
}
},
"required": [
"recipient",
"amount",
"network",
"approxCents"
]
}
}
}
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/nevermined-app-quote-result-dto"
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.