---
title: "List Agents"
method: GET
path: "/protocol/agents"
tags: ["Protocol - Agents"]
---

# List Agents

`GET /protocol/agents`

## Request

- Base URL: `https://api.sandbox.nevermined.app/api/v1`
- URL: `https://api.sandbox.nevermined.app/api/v1/protocol/agents`
- Auth: HTTP bearer

Get paginated list of agents for the current user.

## Query parameters

- `page` integer
- `offset` integer
- `sortBy` string
- `sortOrder` 'asc' | 'desc'

## Response `200`

List of agents

- PaginatedAgents
  - `agents` Agent[]
    - `agentId` string
    - `name` string
    - `description` string
    - `tags` string[]
    - `endpoints` object[]
    - `agentDefinitionUrl` string
    - `plans` object[]
      - `planId` string
      - `name` string
    - `isListed` boolean
    - `owner` string
  - `totalCount` integer
  - `page` integer
  - `offset` integer

## Other responses

- `401`: Unauthorized

---

[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)