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

# List connected agents (AgentBindings) for the signed-in user

> Browser-initiated. Both credential types in one view, each with its human-facing lifecycle state. Paginated with the API-wide page/offset convention; totalResults is the honest cross-page total, and the applied page/offset are echoed back.



## OpenAPI

````yaml /api-reference/oauth-openapi.json get /oauth/bindings
openapi: 3.0.0
info:
  title: Nevermined Authentication API
  description: >-
    The OAuth 2.1 + RFC 8628 device-flow ceremony and standards-based discovery
    endpoints an agent or connector uses to obtain and manage a Nevermined
    credential. These endpoints are root-mounted (not under /api/v1).
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.sandbox.nevermined.app
    description: Sandbox
  - url: https://api.live.nevermined.app
    description: Live
security: []
tags:
  - name: Authentication - Ceremony
    x-group: Ceremony
    description: Authorization Code (PKCE) and RFC 8628 device grant.
  - name: Authentication - Connections
    x-group: Connections
    description: AgentBindings — the consent receipts a user manages.
  - name: Authentication - Discovery
    x-group: Discovery
    description: RFC 8414 / 9728 / JWKS metadata.
paths:
  /oauth/bindings:
    get:
      tags:
        - Authentication - Connections
      summary: List connected agents (AgentBindings) for the signed-in user
      description: >-
        Browser-initiated. Both credential types in one view, each with its
        human-facing lifecycle state. Paginated with the API-wide page/offset
        convention; totalResults is the honest cross-page total, and the applied
        page/offset are echoed back.
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number, 1-indexed. Defaults to 1.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            default: 50
            minimum: 1
            maximum: 100
          description: Page size. Defaults to 50, clamped to a max of 100.
      responses:
        '200':
          description: The user's connected agents
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentBindingList'
        '401':
          $ref: '#/components/responses/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    AgentBindingList:
      type: object
      properties:
        bindings:
          type: array
          items:
            $ref: '#/components/schemas/AgentBindingSummary'
        totalResults:
          type: integer
          example: 3
          description: Honest total across all pages.
        page:
          type: integer
          example: 1
        offset:
          type: integer
          example: 50
          description: Page size actually applied (clamped to a max of 100).
    AgentBindingSummary:
      type: object
      properties:
        bindingId:
          type: string
          example: ab-a1b2c3d4
        clientId:
          type: string
          example: fleet
          description: The connector fronting the connection.
        agentId:
          type: string
          nullable: true
          example: agent-weather-bot
        consentType:
          type: string
          enum:
            - credits_purchase
            - account_access
          example: credits_purchase
        resource:
          type: string
          nullable: true
          example: https://api.sandbox.nevermined.app
        planId:
          type: string
          nullable: true
          example: '123456789'
        delegationId:
          type: string
          nullable: true
          example: del-1
        spendingLimitCents:
          type: string
          nullable: true
          example: '5000'
        amountSpentCents:
          type: string
          nullable: true
          example: '1200'
        currency:
          type: string
          nullable: true
          example: usd
        state:
          type: string
          enum:
            - active
            - expired
            - exhausted
            - revoked
          example: active
        createdAt:
          type: string
          format: date-time
          example: '2026-07-01T10:30:00Z'
        lastUsedAt:
          type: string
          nullable: true
          format: date-time
          example: '2026-07-20T14:00:00Z'
        revokedAt:
          type: string
          nullable: true
          format: date-time
          example: null
    ErrorEnvelope:
      type: object
      properties:
        code:
          type: string
          example: BCK.OAUTH.0016
        message:
          type: string
          example: Unknown OAuth client
        category:
          type: string
          enum:
            - validation
            - auth
            - business
            - integration
            - internal
          example: auth
        hint:
          type: string
          nullable: true
        retryable:
          type: boolean
          nullable: true
          description: When present, whether retrying the same request may succeed.
        httpStatus:
          type: integer
          example: 400
  responses:
    Error:
      description: Typed error envelope
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Nevermined API key
      description: >-
        A Nevermined API key: `Authorization: Bearer <sandbox:… | live:…>`.
        Environment-prefixed, not a bare JWT — send the whole string.

````

## Related topics

- [Connected Agents](/docs/integrate/authentication/connections.md)
- [Revoke an AgentBinding by id](/docs/api-reference/authentication--connections/revoke-an-agentbinding-by-id.md)
- [Authorization Code + PKCE](/docs/integrate/authentication/oauth-authorization-code.md)
- [Approve or deny a device authorization](/docs/api-reference/authentication--ceremony/approve-or-deny-a-device-authorization.md)
- [Resolve a user_code to its verification-page details](/docs/api-reference/authentication--ceremony/resolve-a-user_code-to-its-verification-page-details.md)