List e-mail senders

GET/v1/email_sendersTry it

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.

Returns

200 application/json. The list (never paginated; an organisation has a handful).

Errors have one shape; see Errors for every code.

Code language

Request

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

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();

import os, requests

res = requests.get(
    "https://api.parasend.com/v1/email_senders",
    headers={
        "Authorization": f"Bearer {os.environ['PARASEND_KEY']}",
    },
)
data = res.json()

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.parasend.com/v1/email_senders");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PARASEND_KEY"));
var response = await http.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

var request = HttpRequest.newBuilder(URI.create("https://api.parasend.com/v1/email_senders"))
    .header("Authorization", "Bearer " + System.getenv("PARASEND_KEY"))
    .GET()
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.parasend.com/v1/email_senders', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'),
    ],
]);
$data = json_decode($response->getBody(), true);

Response · 200

{
  "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
}