---
title: "List email destinations emailSend may use."
method: GET
path: "/v1/email/destinations"
tags: ["email"]
---

# List email destinations emailSend may use.

`GET /v1/email/destinations`

## Request

- Base URL: `https://api.kody.codes`
- URL: `https://api.kody.codes/v1/email/destinations`
- Auth: HTTP bearer

List email destinations emailSend may use. Mail comes from your platform address. The account identity email is always included. Extra addresses must be verified before emailSend can use them.

Org permission: `email:read`.

## Response `200`

Success.

- object
  - `destinations` object[], required
    - `id` string, required
    - `email` string, required
    - `kind` 'identity' | 'additional', required
    - `verified` boolean, required
    - `is_default` boolean, required
    - `can_remove` boolean, required
  - `additional_limit` number, required
  - `additional_remaining` number, required

## Other responses

- `400`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `401`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `403`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `404`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `409`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `413`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `429`: Too many requests (edge IP/token limit) or an entitlement / plan-cap limit. Wait at least `Retry-After` seconds before retrying.
- `500`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `503`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `default`: Error envelope `{ "error": { "code", "message", "details"? } }`.

---

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