# List e-mail senders

`GET https://api.parasend.com/v1/email_senders`

Source: https://parasend.com/docs/api/email-senders/list

Authentication: `Authorization: Bearer <API key>` (a `ps_test_` key in test mode, `ps_live_` in live mode).

Your organisation's own sending addresses: notices From an address on your own domain instead of Parasend's. You add, change and remove a sender in the portal (under E-mail senders), where Parasend shows the DNS records to publish; with a key you can follow its state, check its DNS and read where Parasend sends from. Oldest first; removed senders are left out. Not paginated: an organisation has a handful. Needs brand_profiles read.

## Example: List e-mail senders

```bash
curl "https://api.parasend.com/v1/email_senders" \
  -H "Authorization: Bearer $PARASEND_KEY"
```

```js
const res = await fetch('https://api.parasend.com/v1/email_senders', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
  },
});
const data = await res.json();
```

## Response 200

The list (never paginated; an organisation has a handful).

```json
{
  "object": "list",
  "data": [
    {
      "id": "es_01M6Q4ZK3H8X2VN7R5T9W1YB3C",
      "object": "email_sender",
      "mode": "parasend_domain",
      "from_address": "tilkynningar@fyrirtaeki.example",
      "domain": "fyrirtaeki.example",
      "mail_from_domain": "mail.fyrirtaeki.example",
      "state": "active",
      "reason": null,
      "records": [
        {
          "record": "ownership",
          "type": "TXT",
          "name": "_parasend-verification.fyrirtaeki.example",
          "value": "parasend-verification=parasend-verify-5f2c9a1e7b",
          "seen": [
            "parasend-verification=parasend-verify-5f2c9a1e7b"
          ],
          "ok": true
        },
        {
          "record": "dkim",
          "type": "CNAME",
          "name": "k3v7q2m9x4p8w1z6._domainkey.fyrirtaeki.example",
          "value": "k3v7q2m9x4p8w1z6.dkim.amazonses.com",
          "seen": [
            "k3v7q2m9x4p8w1z6.dkim.amazonses.com"
          ],
          "ok": true
        },
        {
          "record": "dkim",
          "type": "CNAME",
          "name": "b5n2r8t4y7u1i9o3._domainkey.fyrirtaeki.example",
          "value": "b5n2r8t4y7u1i9o3.dkim.amazonses.com",
          "seen": [
            "b5n2r8t4y7u1i9o3.dkim.amazonses.com"
          ],
          "ok": true
        },
        {
          "record": "dkim",
          "type": "CNAME",
          "name": "h6j2l8c4v9b1n5m7._domainkey.fyrirtaeki.example",
          "value": "h6j2l8c4v9b1n5m7.dkim.amazonses.com",
          "seen": [
            "h6j2l8c4v9b1n5m7.dkim.amazonses.com"
          ],
          "ok": true
        },
        {
          "record": "mail_from_mx",
          "type": "MX",
          "name": "mail.fyrirtaeki.example",
          "value": "10 feedback-smtp.eu-west-1.amazonses.com",
          "seen": [
            "10 feedback-smtp.eu-west-1.amazonses.com"
          ],
          "ok": true
        },
        {
          "record": "mail_from_spf",
          "type": "TXT",
          "name": "mail.fyrirtaeki.example",
          "value": "v=spf1 include:amazonses.com ~all",
          "seen": [
            "v=spf1 include:amazonses.com ~all"
          ],
          "ok": true
        },
        {
          "record": "dmarc",
          "type": "TXT",
          "name": "_dmarc.fyrirtaeki.example",
          "value": "v=DMARC1; p=none;",
          "seen": [
            "v=DMARC1; p=none"
          ],
          "ok": true
        }
      ],
      "dkim_pending": false,
      "used_by": {
        "brand_profiles": 0
      },
      "verified_at": "2026-11-07T11:34:38.958Z",
      "active_since": "2026-11-07T11:34:38.958Z",
      "degraded_since": null,
      "failed_at": null,
      "last_checked_at": "2026-11-09T11:24:38.958Z",
      "created_at": "2026-11-07T11:34:38.958Z",
      "removed_at": null,
      "on_failure": "fallback",
      "held": null
    }
  ],
  "has_more": false
}
```

Errors: one shape, `{"error": {type, code, message, param, request_id}}`; every code is listed at https://parasend.com/docs/errors.