List Email Domains

Beta

GET/v1/messaging/email-domains

This endpoint is idempotent. Learn more

Returns the account's registered email domains.

Permissions requiredValues:messaging:read

The role behind your API key or agent must grant every one of these permissions.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

Relative URL that fetches the next page of results.

null when the last page has been reached.

previous_page_urlstringnullable

Relative URL that fetches the previous page of results.

null while on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of email_domain

Resources in this page.

idstring

Email domain ID.

objectstringenumValues:email_domain

Resource type identifier.

domainstring

The fully-qualified domain name (e.g. support.acme.com).

statusstring

Verification status.

pending: registered and awaiting DKIM confirmation.
verified: DKIM confirmed; the domain can send and receive mail.
failed: verification could not be completed.

dkim_tokensarray of string

The DKIM CNAME tokens the customer must publish in DNS to verify the domain.

verified_atstring (date-time)nullable

When the domain's DKIM verification was confirmed.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

200

Successful response for List Email Domains

List Email Domains

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listEmailDomain = await client.messaging.emailDomains.list();

console.log(listEmailDomain.data);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listEmailDomain = await client.messaging.emailDomains.list();

console.log(listEmailDomain.data);

200 example

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/messaging/email-domains?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoiZW1kb21fMDE4ZTg4MDcyZDEzMjA4MDhkYzlhYWEwMSIsImQiOiJmIn0.tw-O9W1-e4_a_1CkgRiJCVR8I30U17cKVM6o_8N_jd0",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "emdom_018e88072d1320808dc9aaa01",
      "object": "email_domain",
      "domain": "support.acme.com",
      "status": "pending",
      "dkim_tokens": [
        "abc123._domainkey.support.acme.com",
        "def456._domainkey.support.acme.com"
      ],
      "verified_at": null,
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/messaging/email-domains?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoiZW1kb21fMDE4ZTg4MDcyZDEzMjA4MDhkYzlhYWEwMSIsImQiOiJmIn0.tw-O9W1-e4_a_1CkgRiJCVR8I30U17cKVM6o_8N_jd0",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "emdom_018e88072d1320808dc9aaa01",
      "object": "email_domain",
      "domain": "support.acme.com",
      "status": "pending",
      "dkim_tokens": [
        "abc123._domainkey.support.acme.com",
        "def456._domainkey.support.acme.com"
      ],
      "verified_at": null,
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

List Email Domains

Authorization

Returns

Responses