> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nevermined.app/llms.txt
> Use this file to discover all available pages before exploring further.

# List Delegations

> 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.



## OpenAPI

````yaml GET /delegation
openapi: 3.1.0
info:
  title: Nevermined API
  description: >-
    API for managing AI agents, payment plans, and x402 payments in the
    Nevermined ecosystem.


    ## Prerequisites


    You need a Nevermined API Key to authenticate. Get one at
    [nevermined.app](https://nevermined.app) under **Settings > API Keys**.


    See the [5-Minute Setup Guide](/docs/integrate/quickstart/5-minute-setup)
    for detailed instructions.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.sandbox.nevermined.app/api/v1
    description: Sandbox (Testing) - Base Sepolia
  - url: https://api.live.nevermined.app/api/v1
    description: Live (Production) - Base Mainnet
security:
  - bearerAuth: []
tags:
  - name: Protocol - Agents
    description: Endpoints for registering and managing AI agents
  - name: Protocol - Plans
    description: Endpoints for creating and managing payment plans
  - name: Protocol - Credits
    description: Endpoints for minting and redeeming credits
  - name: Protocol - Access
    description: Endpoints for access tokens and request validation
  - name: X402 - Permissions
    description: Endpoints for x402 delegated permissions
paths:
  /delegation:
    get:
      tags:
        - Delegation
      summary: List all delegations for the authenticated user
      description: >-
        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.
      operationId: DelegationController_listDelegations
      parameters:
        - name: page
          required: false
          in: query
          description: Page number (1-based). Defaults to 1.
          schema:
            type: integer
            default: 1
        - name: offset
          required: false
          in: query
          description: Number of items per page. Defaults to 10.
          schema:
            type: integer
            default: 10
        - name: accessible
          required: false
          in: query
          description: >-
            When "true", return only delegations accessible to the requesting
            API key (filters by apiKeyId, Active status, expiry, and remaining
            budget)
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DelegationListDto'
components:
  schemas:
    DelegationListDto:
      type: object
      properties:
        totalResults:
          type: number
        page:
          type: number
        offset:
          type: number
        delegations:
          type: array
          items:
            $ref: '#/components/schemas/DelegationSummaryDto'
      required:
        - totalResults
        - page
        - offset
        - delegations
    DelegationSummaryDto:
      type: object
      properties:
        delegationId:
          type: string
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        provider:
          type: string
          example: stripe
        providerPaymentMethodId:
          type: string
          example: pm_1Abc2Def3Ghi4Jkl
        status:
          type: string
          example: Active
          enum:
            - Active
            - Revoked
            - Expired
            - Exhausted
        spendingLimitCents:
          type: string
          example: '10000'
        amountSpentCents:
          type: string
          example: '2500'
        remainingBudgetCents:
          type: string
          example: '7500'
        currency:
          type: string
          example: usd
        transactionCount:
          type: number
          example: 12
        expiresAt:
          format: date-time
          type: string
          example: '2026-02-20T00:00:00Z'
        createdAt:
          format: date-time
          type: string
          example: '2026-02-13T10:30:00Z'
        apiKeyId:
          type: string
          example: sk-abc123
          nullable: true
          description: >-
            NVM API Key ID restricted to this delegation. Null = any key can use
            it.
      required:
        - delegationId
        - provider
        - providerPaymentMethodId
        - status
        - spendingLimitCents
        - amountSpentCents
        - remainingBudgetCents
        - currency
        - transactionCount
        - expiresAt
        - createdAt
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your Nevermined API Key (starts with 'nvm:'). Get one at
        [nevermined.app](https://nevermined.app) under **Settings > API Keys**.

````

## Related topics

- [List Delegation Transactions](/docs/api-reference/delegation/list-delegation-transactions.md)
- [X402 Protocol](/docs/api-reference/typescript/x402.md)
- [Card Delegation](/docs/solutions/card-delegation.md)
- [List Agents](/docs/api-reference/protocol/list-agents.md)
- [List Plans](/docs/api-reference/protocol/list-plans.md)