Skip to main content
GET
Get delegation details including remaining budget

Authorizations

Authorization
string
header
required

Your Nevermined API Key (starts with 'nvm:'). Get one at nevermined.app under Settings > API Keys.

Path Parameters

delegationId
string<uuid>
required

UUID v4 of the delegation to fetch.

Query Parameters

withPayer
enum<string>

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.

Available options:
true,
false

Response

delegationId
string
required
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

provider
string
required
Example:

"stripe"

providerPaymentMethodId
string
required
Example:

"pm_1Abc2Def3Ghi4Jkl"

status
enum<string>
required
Available options:
Active,
Revoked,
Expired,
Exhausted
Example:

"Active"

spendingLimitCents
string
required
Example:

"10000"

amountSpentCents
string
required
Example:

"2500"

remainingBudgetCents
string
required
Example:

"7500"

currency
string
required
Example:

"usd"

transactionCount
number
required
Example:

12

expiresAt
string<date-time>
required
Example:

"2026-02-20T00:00:00Z"

createdAt
string<date-time>
required
Example:

"2026-02-13T10:30:00Z"

planId
string | null
required
Example:

"123456789"

maxTransactions
integer | null
required
Example:

50

lastUsedAt
string<date-time> | null
required
Example:

"2026-02-13T14:00:00Z"

apiKeyId
string | null

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

Example:

"sk-abc123"

fundingWalletAddress
string | null

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:

"0x1234abcd5678ef901234abcd5678ef901234abcd"

lockedInChannels
object[] | null

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.