---
title: "List P2P instances"
method: GET
path: "/instance"
tags: ["instances"]
---

# List P2P instances

`GET /instance`

## Request

- Base URL: `http://localhost/v1`
- URL: `http://localhost/v1/instance`
- Auth: none declared
- TypeScript: <https://skmtc.dev/subutai-io/apis/subutai-p2p/docs/instance/get.ts> (a function with typed inputs; its response is checked against the schema)

List all p2p instances

## Response `200`

Sucessful operation

- Instance[]
  - `hash` string
  - `interface` Interface
    - `name` string
    - `ip` string
    - `mac` string
  - `port` string: Specific UDP port or port range [from-to]
  - `key` Key
    - `key` string
    - `keyfile` string
    - `until` string

## Other responses

- `503`: Service unavailable

## Changes

- **2018-04-16** `50f5b2633e9c`: 2 info
  - added the non-success response with the status `503`
  - added the success response with the status `200`
- **2018-04-11** `64b8b394694a`: 3 info
  - api operation id `ListInstances` was added
  - api tag `instances` added
  - api tag `instance` removed
- **2018-03-26** `19a991c3ee7b`: 1 breaking, 4 info
  - removed the success response with the status `200`
  - api operation id `ListInstances` removed and replaced with ``
  - api tag `instance` added
  - api tag `instances` removed
  - …1 more

[Operation history](https://skmtc.dev/subutai-io/apis/subutai-p2p/changes/instance/get.md)

---

[API](https://skmtc.dev/subutai-io/apis/subutai-p2p.md) - [All operations](https://skmtc.dev/subutai-io/apis/subutai-p2p/llms.txt) - [OpenAPI document](https://skmtc.dev/subutai-io/apis/subutai-p2p/revisions/9160372d4103?raw)