Delegation

List all delegations for the authenticated user

Returns a paginated list of the authenticated user's spending delegations. Use accessible=true to return only delegations the requesting API key may spend against. Requires a Nevermined API key.

get/delegation

Request

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

Query parameters

pageinteger

Page number (1-based). Defaults to 1.

offsetinteger

Number of items per page. Defaults to 10.

accessible'true' | 'false'

When "true", return only delegations accessible to the requesting API key (filters by apiKeyId, Active status, expiry, and remaining budget)

Response

totalResultsnumber required
pagenumber required
offsetnumber required

Example response

{
  "delegations": [
    {
      "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"
    }
  ]
}

Changes

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