# Retrieve an e-mail sender

`GET https://api.parasend.com/v1/email_senders/{id}`

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

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

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

## Path parameters

- `id` (string, required)

## Example: Retrieve an e-mail sender

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

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

## Response 200

The sender, removed ones included.

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

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