---
title: "List project instances"
method: GET
path: "/v1/projects/{projectId}/instances"
tags: ["Projects"]
---

# List project instances

`GET /v1/projects/{projectId}/instances`

## Request

- Base URL: `https://api.spice.ai`
- URL: `https://api.spice.ai/v1/projects/{projectId}/instances`
- Auth: HTTP bearer

Lists the runtime instances of a deployed project, newest first. A managed or BYOC project lists its Spicepod instances. A standalone project lists its Cloud Connect runtime. Read the logs of an instance with `GET /v1/projects/{projectId}/instances/{instanceName}/logs`.

## Path parameters

- `projectId` integer, required

## Headers

- `X-Org-Name` string

## Response `200`

The project's instances

- object
  - `instances` ProjectInstance[], required
    - `name` string, required: The instance name: a Spicepod instance (pod) name, or a Cloud Connect runtime id. Pass it as `instanceName` to read its logs.
    - `status` 'deploying' | 'loading' | 'ready' | 'unhealthy' | 'terminating' | 'failed' | 'failed_to_start' | 'online' | 'offline', required: A Spicepod instance is `deploying`, `loading`, `ready`, `unhealthy`, `terminating`, `failed`, or `failed_to_start`. A Cloud Connect runtime is `online` or `offline`.
    - `started_at` string, date-time, nullable, required: When the Spicepod instance started, or when the Cloud Connect runtime enrolled.

## Other responses

- `400`: Invalid project ID
- `401`: Unauthorized
- `403`: Insufficient scope
- `404`: Project not found
- `409`: The project has no running instances. `code` is `project_not_deployed` when a managed or BYOC project was never deployed, or `project_paused` when the project is paused.
- `422`: The project is not fully configured
- `500`: Internal server error
- `503`: The project runtime did not answer

---

[API](https://skmtc.dev/spice/apis/spice-cloud-control-plane-api.md) - [All operations](https://skmtc.dev/spice/apis/spice-cloud-control-plane-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spice/apis/spice-cloud-control-plane-api/revisions/5f3b75dd847d?raw)