> For the complete documentation index, see [llms.txt](https://teamhycon.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://teamhycon.gitbook.io/docs/api-v1-1/fetching-peer-s/getting-a-list-of-peers.md).

# Getting a list of peers

Retrieve a list of peers connected to your Hycon node.

**Response - `200 OK, application/json`**

| Parameter     | Type      | Description                                         |
| ------------- | --------- | --------------------------------------------------- |
| `host`        | string    | IP address of the peer                              |
| `port`        | number    | Port connected with the peer                        |
| `lastSeen`    | timestamp | Most recent timestamp the peer was seen             |
| `failCount`   | number    | Number of connection failures                       |
| `lastAttempt` | timestamp | Most recent timestamp the peer attempted connection |
| `active`      | number    | Activity of the peer                                |

GET/api/v1/peerList

**Example request**

```
$ curl -X GET http://localhost:2442/api/v1/peerList \
    -H 'Content-Type: application/json;charset=utf-8'
```

**Response (Success)**

```
[
    {
        "host": "110.14.194.10",
        "port": 8148,
        "lastSeen": "11/14/2018, 12:08:14 PM",
        "failCount": 0,
        "lastAttempt": "11/14/2018, 12:08:14 PM",
        "active": 2
    },
    ...
]
```