---
title: "Get delegation details including remaining budget"
method: GET
path: "/delegation/{delegationId}"
tags: ["Delegation"]
---

# Get delegation details including remaining budget

`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

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.

## Path parameters

- `delegationId` string, uuid, required

## Query parameters

- `withPayer` 'true' | 'false'

## Response `200`

- DelegationDetailsDto
  - `delegationId` string, required
  - `provider` string, required
  - `providerPaymentMethodId` string, required
  - `status` 'Active' | 'Revoked' | 'Expired' | 'Exhausted', required
  - `spendingLimitCents` string, required
  - `amountSpentCents` string, required
  - `remainingBudgetCents` string, required
  - `currency` string, required
  - `transactionCount` number, required
  - `expiresAt` string, date-time, required
  - `createdAt` string, date-time, required
  - `apiKeyId` string, nullable: NVM API Key ID restricted to this delegation. Null = any key can use it.
  - `planId` string, nullable, required
  - `maxTransactions` integer, nullable, required
  - `lastUsedAt` string, date-time, nullable, required
  - `fundingWalletAddress` string, 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.
  - `lockedInChannels` LockedChannelFundsDto[], nullable: 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.
    - `network` integer, required: Chain id the payment channels are on
    - `token` string, required: The token the channels hold in escrow, EIP-55 checksummed
    - `symbol` string, nullable, required: Ticker, or null when the token is not one Nevermined recognises
    - `decimals` integer, nullable, required: Decimal scale of `atomic`, or null when unknown
    - `atomic` string, required: 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` string, nullable, required: Human-readable amount; null exactly when `decimals` is

## Other responses

- `404`: Delegation not found

---

[API](https://skmtc.dev/nevermined/apis/nevermined-api.md) · [All operations](https://skmtc.dev/nevermined/apis/nevermined-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nevermined/apis/nevermined-api/revisions/cabbe618c80b?raw)