---
title: "List instances for this add-on."
method: GET
path: "/organisations/{id}/addons/{addonId}/instances"
tags: ["all", "addons", "organisations"]
---

# List instances for this add-on.

`GET /organisations/{id}/addons/{addonId}/instances`

## Query parameters

- `deploymentId` string
- `withDeleted` string

## Response `200`

The instance list

- SupernovaInstanceView[] — List of instances.
  - `appId` string — Identifier of running app/add-on
  - `appPort` number, required — Port of the HV that's redirected to 8080 on VM
  - `commitId` string
  - `createdAt` number — Integer unix timestamp
  - `deployId` string
  - `deployNumber` number
  - `displayName` string — Generated PokéName. This name is generated from the uuid.
  - `flavor` object, required — The instance "flavor": memory, cpu, disk size…
    - `cpus` number
    - `mem` number
    - `name` string — Name of flavor. For indication only.
    - `price` number
  - `hv` string, required — String name of hv.
  - `image` string, required — Base system image. E.g. java-20181030, node-20180912…
  - `instanceNumber` number
  - `internalIP` string
  - `ip` string, required — Public IP of the HV
  - `ownerId` string — Identifier of the owner of the app/add-on running
  - `source` string, required — Who/what started this instance? E.g. "app", "cli"
  - `sshPort` number — Port of the HV that's redirected to 22 on VM
  - `state` string
  - `uuid` string, required
  - `zabbixPort` number, required — Port of the HV that's redirected to 10050 on VM
  - `zone` string

---

[API](https://skmtc.net/clevercloud/apis/clever-cloud.md) · [All operations](https://skmtc.net/clevercloud/apis/clever-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clevercloud/clever-cloud/versions/942b2ee2906a/schema)