Nevermined · Schema

DelegationDetailsDto

PaymentsArtificial IntelligencePlatformFintechAI Agents

Properties

Name Type Description
allowSessionPayments boolean erc4337 only: whether this delegation may pay services that sell over an MPP `session`, which lock a refundable deposit from the wallet at the first call. Set at creation.
agentId stringnull Buyer-supplied agent identifier; attribution only.
label stringnull Buyer-chosen agent name.
delegationId string
provider string
providerPaymentMethodId string
status string
spendingLimitCents string
amountSpentCents string What the delegation has spent, rounded UP to a whole cent. The cap accrues at sub-cent resolution — `amountSpentMicros` is the exact figure — so this is within one cent of it, and `amountSpentCents +
amountSpentMicros string What the delegation has spent, in micros — millionths of the currency unit, i.e. 1/10,000 of a cent. The figure the spending cap is enforced on.
remainingBudgetCents string Whole cents left under the cap: `spendingLimitCents - amountSpentCents`, never negative.
remainingBudgetMicros string Micros left under the cap, never negative. A delegation with any micros left can still take a payment that fits in them, even when `remainingBudgetCents` reads 0.
currency string
transactionCount number
maxTransactions numbernull Maximum number of payments this delegation may make, or null for no count limit.
expiresAt string
createdAt string
apiKeyId stringnull Legacy key-id pin: the NVM API Key ID this delegation is restricted to. Null does NOT necessarily mean "any key" — check `bindingId`: a delegation pinned to an AgentBinding has `apiKeyId: null` but is
bindingId stringnull AgentBinding this delegation is pinned to — stable across credential refresh, unlike `apiKeyId`. When set, only credentials minted from this binding may use it (and `apiKeyId` is null). Null = not bin
planId stringnull Plan this delegation is restricted to, or null for a plan-agnostic one that can pay any plan. Applies to every provider, `visa` included: a Visa delegation created without a plan is null here, while o
lastUsedAt stringnull
fundingWalletAddress stringnull On-chain wallet the Router crypto rail spends from for this delegation — the caller EOA (7702 kernel address for migrated wallets) for a personal delegation, or the organization wallet for an org-wall
lockedInChannels arraynull Money `fundingWalletAddress` has deposited into MPP session payment channels and can still get back, per chain and token. It has left the wallet but it is not spent and it is not charged to this budge
spendable arraynull An upper bound on what this delegation can spend now: `remainingBudgetMicros` is only a ceiling, and a crypto delegation can spend no more than its funding wallet holds. One entry per network the Rout
View JSON Schema on GitHub

JSON Schema

nevermined-app-delegation-details-dto-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/nevermined-app/json-schema/nevermined-app-delegation-details-dto-schema.json",
  "title": "DelegationDetailsDto",
  "x-generated": "2026-11-20",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/nevermined-app-openapi.json#/components/schemas/DelegationDetailsDto",
  "type": "object",
  "properties": {
    "allowSessionPayments": {
      "type": "boolean",
      "description": "erc4337 only: whether this delegation may pay services that sell over an MPP `session`, which lock a refundable deposit from the wallet at the first call. Set at creation."
    },
    "agentId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Buyer-supplied agent identifier; attribution only."
    },
    "label": {
      "type": [
        "string",
        "null"
      ],
      "description": "Buyer-chosen agent name."
    },
    "delegationId": {
      "type": "string"
    },
    "provider": {
      "type": "string",
      "enum": [
        "stripe",
        "braintree",
        "erc4337",
        "visa",
        "vgs"
      ]
    },
    "providerPaymentMethodId": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "Active",
        "Revoked",
        "Expired",
        "Exhausted"
      ]
    },
    "spendingLimitCents": {
      "type": "string"
    },
    "amountSpentCents": {
      "type": "string",
      "description": "What the delegation has spent, rounded UP to a whole cent. The cap accrues at sub-cent resolution — `amountSpentMicros` is the exact figure — so this is within one cent of it, and `amountSpentCents + remainingBudgetCents` equals `spendingLimitCents` while the delegation is within its cap."
    },
    "amountSpentMicros": {
      "type": "string",
      "description": "What the delegation has spent, in micros — millionths of the currency unit, i.e. 1/10,000 of a cent. The figure the spending cap is enforced on."
    },
    "remainingBudgetCents": {
      "type": "string",
      "description": "Whole cents left under the cap: `spendingLimitCents - amountSpentCents`, never negative."
    },
    "remainingBudgetMicros": {
      "type": "string",
      "description": "Micros left under the cap, never negative. A delegation with any micros left can still take a payment that fits in them, even when `remainingBudgetCents` reads 0."
    },
    "currency": {
      "type": "string"
    },
    "transactionCount": {
      "type": "number"
    },
    "maxTransactions": {
      "type": [
        "number",
        "null"
      ],
      "description": "Maximum number of payments this delegation may make, or null for no count limit."
    },
    "expiresAt": {
      "format": "date-time",
      "type": "string"
    },
    "createdAt": {
      "format": "date-time",
      "type": "string"
    },
    "apiKeyId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Legacy key-id pin: the NVM API Key ID this delegation is restricted to. Null does NOT necessarily mean \"any key\" — check `bindingId`: a delegation pinned to an AgentBinding has `apiKeyId: null` but is still restricted. Null on BOTH = any of the owner's keys may use it."
    },
    "bindingId": {
      "type": [
        "string",
        "null"
      ],
      "description": "AgentBinding this delegation is pinned to — stable across credential refresh, unlike `apiKeyId`. When set, only credentials minted from this binding may use it (and `apiKeyId` is null). Null = not binding-pinned."
    },
    "planId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Plan this delegation is restricted to, or null for a plan-agnostic one that can pay any plan. Applies to every provider, `visa` included: a Visa delegation created without a plan is null here, while one created with a plan keeps it and can only settle that plan."
    },
    "lastUsedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "fundingWalletAddress": {
      "type": [
        "string",
        "null"
      ],
      "description": "On-chain wallet the Router crypto rail spends from for this delegation — the caller EOA (7702 kernel address for migrated wallets) for a personal delegation, or the organization wallet for an org-wallet delegation. Fund/check THIS wallet before a Router call. For a personal delegation the Router does NOT spend from `providerPaymentMethodId` (the smart-account address) — it spends from the EOA; for an org-wallet delegation `providerPaymentMethodId` IS this wallet. (On the default wallet mode the same delegation used for a plan-purchase settles from the smart account instead — this field is the Router payer specifically.) Only returned when requested with `?withPayer=true`. `null` on card-backed delegations (a card is not funded from a wallet — tell them apart by `provider`: `erc4337` is the crypto rail); `null` on a crypto delegation means the payer wallet could not be resolved — either the owner profile has no wallet (permanent) or the lookup failed transiently."
    },
    "lockedInChannels": {
      "description": "Money `fundingWalletAddress` has deposited into MPP session payment channels and can still get back, per chain and token. It has left the wallet but it is not spent and it is not charged to this budget: it comes back to the wallet when the channel closes. It is the FUNDING WALLET’s total, not a per-delegation figure: every delegation spending from the same wallet reports the same channels. Only returned when requested with `?withPayer=true`. An empty list means nothing is locked, and is what a card-backed delegation reports. `null` means it could not be determined (the funding wallet could not be resolved, or the read failed), which is not the same as nothing locked.",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/LockedChannelFundsDto"
      }
    },
    "spendable": {
      "description": "An upper bound on what this delegation can spend now: `remainingBudgetMicros` is only a ceiling, and a crypto delegation can spend no more than its funding wallet holds. One entry per network the Router is configured to pay the token of the budget’s currency on, each the lesser of the remaining budget and the wallet’s balance of that token there, and for an organization wallet what the spending member’s group budget has left; a call settles on the network the merchant quotes, so only that network’s entry applies to it. It is a bound, not a promise: it does not subtract payments authorized but not settled yet, routing fees owed but not collected yet, or gas. It applies to a payment in the budget’s token: a personal crypto delegation can also pay a merchant in another stablecoin the Router funds, from that token’s balance, which can be higher or lower. A card-backed delegation has one entry with `network: null` equal to the remaining budget. Zero on every entry when the delegation is not Active. Only returned when requested with `?withPayer=true`. An empty list means the Router pays the budget’s token on no network this deployment serves. `null` means it could not be determined: the funding wallet could not be resolved, the budget’s currency maps to no token, or the delegation’s payment rail is one this read has no rule for.",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/DelegationSpendableDto"
      }
    }
  },
  "required": [
    "delegationId",
    "provider",
    "providerPaymentMethodId",
    "status",
    "spendingLimitCents",
    "amountSpentCents",
    "amountSpentMicros",
    "remainingBudgetCents",
    "remainingBudgetMicros",
    "currency",
    "transactionCount",
    "maxTransactions",
    "expiresAt",
    "createdAt",
    "lastUsedAt"
  ],
  "$defs": {
    "DelegationSpendableDto": {
      "type": "object",
      "properties": {
        "network": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Chain id, or null for a card-backed delegation, which no wallet funds."
        },
        "networkName": {
          "type": [
            "string",
            "null"
          ],
          "description": "The Router’s canonical name for the chain. A quote may name the same chain differently, such as `eip155:<network>`, so match a quote to an entry by `network`, the chain id. Null exactly when `network` is null."
        },
        "spendableMicros": {
          "type": [
            "string",
            "null"
          ],
          "pattern": "^(0|[1-9][0-9]*)$",
          "description": "Micros (1/10,000 of a cent, like `remainingBudgetMicros`): no more than this can be spent now on `network` in the budget’s token. The lesser of the remaining budget and the funding wallet’s balance there, rounded down, and for an organization wallet what the spending member’s group budget has left. `null` when it could not be determined in time (the wallet’s balance on this network or, for an organization wallet, its group budget could not be read), which is not zero; never null when `network` is null."
        }
      },
      "required": [
        "network",
        "networkName",
        "spendableMicros"
      ]
    },
    "LockedChannelFundsDto": {
      "type": "object",
      "properties": {
        "network": {
          "type": "integer",
          "description": "Chain id the payment channels are on"
        },
        "token": {
          "type": "string",
          "description": "The token the channels hold in escrow, EIP-55 checksummed"
        },
        "symbol": {
          "type": [
            "string",
            "null"
          ],
          "description": "Ticker, or null when the token is not one Nevermined recognises"
        },
        "decimals": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Decimal scale of `atomic`, or null when unknown"
        },
        "atomic": {
          "type": "string",
          "pattern": "^(0|[1-9][0-9]*)$",
          "description": "Atomic (integer) amount locked, as a string: over every payment channel on this chain and token that is not closed yet, the deposit minus the payments its vouchers already authorized."
        },
        "formatted": {
          "type": [
            "string",
            "null"
          ],
          "description": "Human-readable amount; null exactly when `decimals` is"
        }
      },
      "required": [
        "network",
        "token",
        "symbol",
        "decimals",
        "atomic",
        "formatted"
      ]
    }
  }
}

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/nevermined-app-delegation-details-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.