# GET /v1/servers

List the servers

Every server of the account, oldest first.

Takes an account key (`ak_…`) as a bearer token. TypeScript: `account.servers.list()`. Python: `account.servers.list()`.

## Responses

### 200 Every server of the account, oldest first.

- `servers` (array of object, required)
  - `serverId` (string (uuid), required): The id every server key, stream and message of the server refers to.
  - `name` (string (at least 1, at most 100 characters), required): The name given at creation, unique within the account.
  - `mode` ("live" | "test", required): live delivers; test goes through everything but delivery, so nothing reaches a recipient. Fixed when the server is created.
  - `createdAt` (string (date-time), required)

Example:

```json
{
  "servers": [
    {
      "serverId": "7c1e4d2a-0b9f-4a3e-8d6c-5e2f1a9b8c70",
      "name": "Invoicing",
      "mode": "live",
      "createdAt": "2026-09-20T12:00:00.000Z"
    }
  ]
}
```

## Errors

Every error answers `error`, the code, and `message`, a sentence for a person. A code that adds fields is shown in full below the table.

| Code | Status | Meaning |
| --- | --- | --- |
| `unauthorized` | 401 | The key is missing, malformed or revoked. |
| `wrong_token_kind` | 403 | The key is of the other kind: a server key (sk_) where an account key (ak_) is needed, or the reverse. The message names the kind the operation takes. |