# peer_reservations_list

[[Source]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/rpc/handlers/Reservations.cpp)

The  method lists [peer reservations](/docs/concepts/networks-and-servers/peer-protocol#fixed-peers-and-peer-reservations).

*The  method is an [admin method](/docs/references/http-websocket-apis/admin-api-methods) that cannot be run by unprivileged users.*

### Request Format

An example of the request format:

WebSocket

```json
{
  "id": "peer_reservations_list_example_1",
  "command": ""
}
```

JSON-RPC

```json
{
  "method": ""
}
```

Commandline

```sh
#Syntax: 
rippled
```

This request does not take any parameters.

### Response Format

An example of a successful response:

WebSocket

```json
{
  "id": "peer_reservations_list_example_1",
  "result": {
    "reservations": [
      {
        "description": "Ripple s1 server 'WOOL'",
        "node": "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
      },
      {
        "node": "n9MZRo92mzYjjsa5XcqnPC7GFYAnENo9VfJzKmpcS9EFZvw5fgwz"
      }
    ]
  },
  "status": "success",
  "type": "response"
}
```

JSON-RPC

```json
{
  "result" : {
    "reservations" : [
       {
          "description" : "Ripple s1 server 'WOOL'",
          "node" : "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
       },
       {
          "node" : "n9MZRo92mzYjjsa5XcqnPC7GFYAnENo9VfJzKmpcS9EFZvw5fgwz"
       }
    ],
    "status" : "success"
  }
}
```

Commandline

```json
Loading: "/etc/rippled.cfg"
2019-Dec-27 21:56:07.253260422 HTTPClient:NFO Connecting to 127.0.0.1:5005

{
  "result" : {
    "reservations" : [
       {
          "description" : "Ripple s1 server 'WOOL'",
          "node" : "n9Jt8awsPzWLjBCNKVEEDQnw4bQEPjezfcQ4gttD1UzbLT1FoG99"
       },
       {
          "node" : "n9MZRo92mzYjjsa5XcqnPC7GFYAnENo9VfJzKmpcS9EFZvw5fgwz"
       }
    ],
    "status" : "success"
  }
}
```

The response follows the [standard format](/docs/references/http-websocket-apis/api-conventions/response-formatting), with a successful result containing the following fields:

| `Field` | Type | Description |
|  --- | --- | --- |
| `reservations` | Array | List of existing [peer reservations](/docs/concepts/networks-and-servers/peer-protocol#fixed-peers-and-peer-reservations). Each member is a peer reservation object, as described below. |


#### Peer Reservation Object

Each member of the `reservations` array is a JSON object describing one [peer reservation](/docs/concepts/networks-and-servers/peer-protocol#fixed-peers-and-peer-reservations). This object has the following fields:

| `Field` | Type | Description |
|  --- | --- | --- |
| `node` | String | The [node public key][] of the peer server this reservation is for, as [base58][]. |
| `description` | String | *(May be omitted)* The description provided with this peer reservation, if any. |


### Possible Errors

- Any of the [universal error types](/docs/references/http-websocket-apis/api-conventions/error-formatting#universal-errors).