# List senders

Source: https://kirora.io/docs/api/reference/listSenders

`GET /v1/senders`

Requires an API key with the `domains:read` scope. [About keys and scopes](https://kirora.io/docs/api/reference/authentication)

Works with integration, agent and partner keys.

The workspace's saved From addresses, the default first, then by name, so an integration or agent picks a From that can send rather than guessing one. `domainVerified` says whether the email can send today; a domain that lost verification leaves its senders listed but false. `from` is the string an email's `from` takes. Senders are added and changed in the dashboard.

## Header parameters

- `Kirora-Workspace` (string, optional, pattern `^[A-Za-z0-9._:-]{1,128}$`) — Partner keys only: the child workspace to act in, by the external id the partner gave it. Without it, a partner key acts in its own workspace. Any other key that sends it is refused with 403, and an unknown workspace is 404.

## Returns

Returns `200 OK` with a list of `Sender` objects in `data`. Otherwise returns an error; [Errors](https://kirora.io/docs/api/reference/errors) lists every code and which to retry.

- `id` (string, required, uuid)
- `name` (string, required) — The display name the inbox shows.
- `email` (string, required)
- `replyTo` (string | null, required)
- `isDefault` (boolean, required) — Whether new emails start with this sender; at most one is.
- `sendingDomainId` (string | null, required, uuid) — The verified sending domain the email is on; null while it can't send.
- `domainVerified` (boolean, required) — Whether the email's domain is verified and can send now.
- `from` (string, required) — "Name <email>", the string an email's `from` takes.
- `createdAt` (string, required, date-time)

## Example

```bash
curl https://api.kirora.io/v1/senders \
  -H "Authorization: Bearer $KIRORA_API_KEY"
```

Response `200`:

```json
{
  "data": [
    {
      "id": "0192f3f1-2b3c-7d4e-8f50-6a7b8c9d0e1f",
      "name": "Acme Shop",
      "email": "hello@mail.acme-shop.com",
      "replyTo": "support@acme-shop.com",
      "isDefault": true,
      "sendingDomainId": "0192f3f0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
      "domainVerified": true,
      "from": "Acme Shop <hello@mail.acme-shop.com>",
      "createdAt": "2026-10-01T09:30:00.000Z"
    }
  ]
}
```