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

# Get Delegation

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



## OpenAPI

````yaml GET /delegation/{delegationId}
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/{delegationId}:
    get:
      tags:
        - Delegation
      summary: Get delegation details including remaining budget
      description: >-
        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.
      operationId: DelegationController_getDelegation
      parameters:
        - name: delegationId
          required: true
          in: path
          description: UUID v4 of the delegation to fetch.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DelegationDetailsDto'
        '404':
          description: Delegation not found
components:
  schemas:
    DelegationDetailsDto:
      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.
        planId:
          type: string
          example: '123456789'
          nullable: true
        merchantAccountId:
          type: string
          example: acct_1Abc2Def3Ghi
          nullable: true
        maxTransactions:
          type: integer
          example: 50
          nullable: true
        lastUsedAt:
          type: string
          example: '2026-02-13T14:00:00Z'
          nullable: true
          format: date-time
      required:
        - delegationId
        - provider
        - providerPaymentMethodId
        - status
        - spendingLimitCents
        - amountSpentCents
        - remainingBudgetCents
        - currency
        - transactionCount
        - expiresAt
        - createdAt
        - planId
        - merchantAccountId
        - maxTransactions
        - lastUsedAt
  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 Delegations](/docs/api-reference/delegation/list-delegations.md)
- [List Delegation Transactions](/docs/api-reference/delegation/list-delegation-transactions.md)
- [Delegation Selection](/docs/products/payments/mandate-selection.md)
- [Delegations](/docs/products/payments/mandates.md)
- [Nevermined x402](/docs/development-guide/nevermined-x402.md)