> For the complete documentation index, see [llms.txt](https://coda-payments.gitbook.io/coda-public-technical-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coda-payments.gitbook.io/coda-public-technical-documentation/codashop-and-distribution/integration-guides/fetch-server-list-request-optional.md).

# Fetch Server List Request (Optional)

Fetch Server List Request is an optional URL that allows Coda to fetch server lists by the get method.

## <mark style="color:purple;">Fetch Server List Response</mark>

The response of the fetch server list request from the partner. It should include serverName, serverId, and isForTest. Below is an example:

Format: JSON\
Format for one-level server list:

```javascript
{
  "serverList": [
    {
      "serverName": "Test Server 1",
      "serverId": "0000001",
      "isForTest": 1
    },
    {
      "serverName": "Server 1",
      "serverId": "1000001",
      "isForTest": 0
    },
    {
      "serverName": "Server 2",
      "serverId": "1000002",
      "isForTest": 0
    }
  ]
}
```

Format for two-level server list:

```javascript
{
  "serverList": {
    "Area 1": [
      {
        "serverName": "Server 1",
        "serverId": "1000001",
        "isForTest": 0
      },
      {
        "serverName": "Server 2",
        "serverId": "1000002",
        "isForTest": 0
      }
    ],
    "Area 2": [
      {
        "serverName": "Server 3",
        "serverId": "1000003",
        "isForTest": 0
      },
      {
        "serverName": "Server 4",
        "serverId": "1000004",
        "isForTest": 0
      }
    ]
  }
}
```

<table><thead><tr><th width="150">Parameter</th><th width="121.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>serverName</td><td>String</td><td>Server Name</td></tr><tr><td>serverId</td><td>String</td><td>Server ID</td></tr><tr><td>isForTest</td><td>Integer</td><td>isForTest is a flag to indicate whether the current server is a test/sandbox server. If isTest is 1, this server is a sandbox/test server; if isTest is 0, this server is a production server. </td></tr></tbody></table>

If you encounter an error, please refer to our [Error Codes list](/coda-public-technical-documentation/codashop-and-distribution/codashop-appendix/codashop-error-codes.md) for more information.&#x20;

<figure><img src="https://content.gitbook.com/content/l56STCN5yoV1K1MhVEvU/blobs/3720q0lojxuIH1d8weQq/server%20list.png" alt=""><figcaption><p>Choose Server</p></figcaption></figure>