---
title: "GET /plugins/{team_name}/{plugin_kind}/{plugin_name}/versions"
method: GET
path: "/plugins/{team_name}/{plugin_kind}/{plugin_name}/versions"
tags: ["plugins"]
---

# GET /plugins/{team_name}/{plugin_kind}/{plugin_name}/versions

`GET /plugins/{team_name}/{plugin_kind}/{plugin_name}/versions`

List all versions for a given plugin

## Path parameters

- `team_name` string, required — The unique name for the team.
- `plugin_kind` 'source' | 'destination' | 'transformer', required — The kind of plugin, ie. source or destination.
- `plugin_name` string, required — The unique name for the plugin.

## Query parameters

- `sort_by` 'created_at'
- `page` integer
- `per_page` integer
- `include_drafts` boolean
- `include_fips` boolean
- `include_prereleases` boolean
- `version_filter` string — A version filter in semantic version format with prefix ranges.

## Response `200`

Response

- object
  - `items` PluginVersionList[], required
    - `created_at` string, date-time, required — The date and time the plugin version was created.
    - `published_at` string, date-time — The date and time the plugin version was set to non-draft (published).
    - `name` string, required — The version in semantic version format.
    - `message` string, required — Description of what's new or changed in this version (supports markdown)
    - `draft` boolean, required — If a plugin version is in draft, it will not show to members outside the team or be counted as the latest version.
    - `retracted` boolean, required — If a plugin version is retracted, assets will still be available for download, but the version will be marked as retracted to discourage use.
    - `protocols` integer[], required — The CloudQuery protocols supported by this plugin version (only protocol 3 is supported by new plugins).
    - `supported_targets` string[], required — The targets supported by this plugin version, formatted as <os>_<arch>
    - `checksums` string[], required — The checksums of the plugin assets
    - `package_type` 'native' | 'docker', required — The package type of the plugin assets
  - `metadata` ListMetadata, required
    - `total_count` integer
    - `last_page` integer
    - `page_size` integer, required
    - `time_ms` integer

## Other responses

- `400` — Bad request
- `401` — Requires authentication
- `403` — Forbidden
- `404` — Resource not found
- `500` — Internal Error

---

[API](https://skmtc.dev/cloudquery/apis/cloudquery-openapi-spec.md) · [All operations](https://skmtc.dev/cloudquery/apis/cloudquery-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudquery/cloudquery-openapi-spec/revisions/ef9782a3ed5e/schema)