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

# Display instance information

`GET /swarm`

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

---

[API](https://skmtc.net/subutai-io/apis/subutai-p2p.md) · [All operations](https://skmtc.net/subutai-io/apis/subutai-p2p/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/subutai-io/subutai-p2p/versions/9160372d4103/schema)