---
title: "List Component Versions"
method: GET
path: "/deploy/components/{component_id}/versions"
tags: ["Deploy"]
---

# List Component Versions

`GET /deploy/components/{component_id}/versions`

## Request

- Base URL: `https://circleci.com/api/v2`
- URL: `https://circleci.com/api/v2/deploy/components/{component_id}/versions`
- Auth: one of:
  - API key in header `Circle-Token`
  - HTTP bearer
  - HTTP basic
  - API key in query parameter `circle-token`

List the versions for a component.

## Path parameters

- `component_id` string, required

## Query parameters

- `environment-id` string, uuid

## Response `200`

Paginated component versions list

- PaginatedComponentVersionList
  - `items` Version[]
    - `name` string: The version name
    - `environment_id` string, uuid: The ID of the environment in which the version has been deployed
    - `namespace` string: The namespace in which the version was deployed
    - `is_live` boolean: Whether the version is live or not
    - `pipeline_id` string, uuid: The ID of the pipeline that deployed the version
    - `workflow_id` string, uuid: The ID of the CircleCI workflow that deployed the version
    - `job_id` string, uuid: The ID of the CircleCI job that deployed the version
    - `job_number` integer: The number of the CircleCI job that deployed the version
    - `last_deployed_at` string, date-time: The time at which the version was last deployed
  - `next_page_token` string, nullable: The pagination token to use when fetching the next page in this result set.

## Other responses

- `400`: Unexpected request body provided.
- `404`: Entity not found.
- `500`: Internal server error.

---

[API](https://skmtc.dev/circleci/apis/circleci-api.md) - [All operations](https://skmtc.dev/circleci/apis/circleci-api/llms.txt) - [OpenAPI document](https://skmtc.dev/circleci/apis/circleci-api/revisions/b9c0e0c24058?raw)