---
title: "Display instance information"
method: GET
path: "/swarm"
tags: ["swarm"]
---

# Display instance information

`GET /swarm`

## Request

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

Display detailed information about specified instance

## Query parameters

- `hash` string, required

## Response `200`

Sucessful operation

- InstanceDetails
  - `id` string
  - `hash` string
  - `interface` Interface
    - `name` string
    - `ip` string
    - `mac` string
  - `port` integer
  - `proxies` Proxy[]
    - `addr` string: UDP address of proxy this instance is connected to
    - `endpoint` string: UDP address of proxy that was binded for current instance
  - `peers` Peer[]
    - `id` string: Unique ID of this peer
    - `state` string: State of the peer on our end
    - `rstate` string: State of our peer on remote end
    - `interface` Interface
      - `name` string
      - `ip` string
      - `mac` string
    - `endpoint` string: Active endpoint
    - `endpoint_pool` string[]
    - `endpoint_list` string[]

## Other responses

- `404`: Hash not found
- `503`: Service unavailable

## Changes

- **2018-04-16** `50f5b2633e9c`: 1 info
  - added the non-success response with the status `404`
- **2018-04-11** `64b8b394694a`: 1 info
  - endpoint added
- **2018-03-26** `19a991c3ee7b`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/subutai-io/apis/subutai-p2p/changes/swarm/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)