Retrieve an e-mail sender

GET/v1/email_senders/{id}Try it

One sender by its es_ ID, removed ones included. Needs brand_profiles read.

Path parameters

idstringrequired

Returns

200 application/json. The sender, removed ones included. See the EmailSender object.

Errors have one shape; see Errors for every code.

Code language

Request

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

const res = await fetch('https://api.parasend.com/v1/email_senders/{id}', {
  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/{id}",
    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/{id}");
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/{id}"))
    .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/{id}', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'),
    ],
]);
$data = json_decode($response->getBody(), true);

Response · 200

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