Delegation

Get delegation details including remaining budget

Returns the full details of a single delegation owned by the authenticated user, including remaining budget and last-used timestamp. Requires a Nevermined API key.

get/delegation/{delegationId}

Request

  • Base URL: https://api.sandbox.nevermined.app/api/v1
  • URL: https://api.sandbox.nevermined.app/api/v1/delegation/{delegationId}
  • Auth: HTTP bearer

Path parameters

delegationIdstring uuid required

UUID v4 of the delegation to fetch.

Query parameters

withPayer'true' | 'false'

When "true", also resolve fundingWalletAddress — the wallet the Router crypto rail spends from (EOA / 7702 kernel, or the org wallet) — and lockedInChannels, what that wallet has locked in MPP payment channels. Opt-in because it adds a wallet lookup and a channel read.

Response

delegationIdstring required
providerstring required
providerPaymentMethodIdstring required
status'Active' | 'Revoked' | 'Expired' | 'Exhausted' required
spendingLimitCentsstring required
amountSpentCentsstring required
remainingBudgetCentsstring required
currencystring required
transactionCountnumber required
expiresAtstring date-time required
createdAtstring date-time required
apiKeyIdstring nullable

NVM API Key ID restricted to this delegation. Null = any key can use it.

planIdstring nullable required
maxTransactionsinteger nullable required
lastUsedAtstring date-time nullable required
fundingWalletAddressstring nullable

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. Only returned when requested with ?withPayer=true. null on card-backed delegations (a card is not funded from a wallet), or on a crypto delegation whose payer wallet could not be resolved.

Example response

{
  "delegationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "provider": "stripe",
  "providerPaymentMethodId": "pm_1Abc2Def3Ghi4Jkl",
  "status": "Active",
  "spendingLimitCents": "10000",
  "amountSpentCents": "2500",
  "remainingBudgetCents": "7500",
  "currency": "usd",
  "transactionCount": 12,
  "expiresAt": "2026-02-20T00:00:00Z",
  "createdAt": "2026-02-13T10:30:00Z",
  "apiKeyId": "sk-abc123",
  "planId": "123456789",
  "maxTransactions": 50,
  "lastUsedAt": "2026-02-13T14:00:00Z",
  "fundingWalletAddress": "0x1234abcd5678ef901234abcd5678ef901234abcd",
  "lockedInChannels": [
    {
      "network": 4217,
      "token": "0x20C000000000000000000000b9537d11c60E8b50",
      "symbol": "USDC.e",
      "decimals": 6,
      "atomic": "6000000",
      "formatted": "6"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.