---
title: "List email servers"
method: GET
path: "/v1/email-servers"
tags: ["forms"]
---

# List email servers

`GET /v1/email-servers`

## Request

- Base URL: `https://api.formcarry.com`
- URL: `https://api.formcarry.com/v1/email-servers`
- Auth: HTTP bearer

The email servers your teams have set up in the dashboard, to use as a form's notification sender: `email_server` is your own SMTP server, `premium_server` a sending domain verified with formcarry. Put the `id` in `self_email_notification.sender.server_id`. Servers are managed in the dashboard.

## Response `200`

- EmailServerList
  - `data` EmailServerResource[], required
    - `id` string, required
    - `team_id` string, required: The team the server belongs to
    - `kind` 'email_server' | 'premium_server', required: email_server: your own SMTP server. premium_server: a sending domain verified with formcarry.
    - `name` string, required
    - `host_or_domain` string, required: The SMTP host, or the verified domain.
    - `active` boolean, required: Whether the server can be used as a sender right now.

## Other responses

- `401`: The request carried no usable key or token.
- `403`: The key is valid but may not do this.
- `429`: Slow down and retry after the Retry-After header.

---

[API](https://skmtc.dev/formcarry/apis/formcarry-api.md) · [All operations](https://skmtc.dev/formcarry/apis/formcarry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formcarry/apis/formcarry-api/revisions/c971f37d5987?raw)