---
title: "List app instances"
method: GET
path: "/api/v1/apps/services/{service_id}/instances"
tags: ["Raff Apps"]
---

# List app instances

`GET /api/v1/apps/services/{service_id}/instances`

## Request

- Base URL: `https://api.rafftechnologies.com`
- URL: `https://api.rafftechnologies.com/api/v1/apps/services/{service_id}/instances`
- Auth: API key in header `X-API-Key`

The app's running instances right now, with their state and restarts.

## Path parameters

- `service_id` string, required

## Response `200`

Instances

- object
  - `success` boolean
  - `instances` AppInstance[]
    - `name` string
    - `phase` 'Running' | 'Pending' | 'Succeeded' | 'Failed'
    - `ready` boolean
    - `restarts` integer
    - `started_at` string: Empty until the instance starts

## Other responses

- `401`: Authentication required
- `404`: Resource not found

## Changes

- **2026-10-19** `e80a4b1b5024`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rafftechnologies/apis/raff-api/changes/api/v1/apps/services/:service_id/instances/get.md)

---

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