---
title: "List Providers"
method: GET
path: "/api/v1/providers"
tags: ["providers"]
---

# List Providers

`GET /api/v1/providers`

## Query parameters

- `user_owned` boolean, nullable
- `origin` string, nullable

## Response `200`

Successful Response

- PaginatedResultModelOutput
  - `items` AgentstackServerApiSchemaCommonEntityModelClassGetitemLocalsModelOutput1[], required
    - `source` union, required
      - string
      - string, uri
    - `id` string, uuid, required
    - `auto_stop_timeout` string, duration
    - `origin` string, required
    - `version_info` VersionInfo
      - `docker` ResolvedDockerImageID
        - `registry` string, required
        - `repository` string, required
        - `tag` string, required
        - `digest` string, required
        - `image_id` string, required
      - `github` ResolvedGithubUrl
        - `host` string
        - `org` string, required
        - `repo` string, required
        - `version` string, required
        - `version_type` 'head' | 'tag', required
        - `commit_hash` string, required
        - `path` string, nullable
    - `registry` union
      - string
      - string, uri
      - string, uri
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `created_by` string, uuid, required
    - `last_active_at` string, date-time
    - `agent_card` AgentCardOutput, required — The AgentCard is a self-describing manifest for an agent. It provides essential metadata including the agent's identity, capabilities, skills, supported communication methods, and security requirements.
      - `additionalInterfaces` AgentInterface[], nullable
        - `transport` string, required
        - `url` string, required
      - `capabilities` AgentCapabilities, required — Defines optional capabilities supported by an agent.
        - `extensions` AgentExtension[], nullable
          - `description` string, nullable
          - `params` object, nullable
          - `required` boolean, nullable
          - `uri` string, required
        - `pushNotifications` boolean, nullable
        - `stateTransitionHistory` boolean, nullable
        - `streaming` boolean, nullable
      - `defaultInputModes` string[], required
      - `defaultOutputModes` string[], required
      - `description` string, required
      - `documentationUrl` string, nullable
      - `iconUrl` string, nullable
      - `name` string, required
      - `preferredTransport` string, nullable
      - `protocolVersion` string, nullable
      - `provider` AgentProvider — Represents the service provider of an agent.
        - `organization` string, required
        - `url` string, required
      - `security` object[], nullable
      - `securitySchemes` object, nullable
      - `signatures` AgentCardSignature[], nullable
        - `header` object, nullable
        - `protected` string, required
        - `signature` string, required
      - `skills` AgentSkill[], required
        - `description` string, required
        - `examples` string[], nullable
        - `id` string, required
        - `inputModes` string[], nullable
        - `name` string, required
        - `outputModes` string[], nullable
        - `security` object[], nullable
        - `tags` string[], required
      - `supportsAuthenticatedExtendedCard` boolean, nullable
      - `url` string, required
      - `version` string, required
    - `state` union, required
      - 'missing' | 'starting' | 'ready' | 'running' | 'error'
      - 'online' | 'offline'
    - `last_error` ProviderErrorMessage
      - `message` string, required
    - `missing_configuration` EnvVar[]
      - `name` string, required
      - `description` string, nullable
      - `required` boolean
    - `type` 'managed' | 'unmanaged', required
    - `managed` boolean, required
    - `env` EnvVar[], required
      - `name` string, required
      - `description` string, nullable
      - `required` boolean
  - `total_count` integer, required
  - `has_more` boolean
  - `next_page_token` string, uuid, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/i-am-bee/apis/agentstack-server.md) · [All operations](https://skmtc.net/i-am-bee/apis/agentstack-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/i-am-bee/agentstack-server/revisions/7d68b3f8bf7f/schema)