Skip to main content
GET
Python SDK

Authorizations

X-SubAccount-ApiKey
string
header
required

This api key can be used only for sub account level operations

Query Parameters

limit
integer
default:20

Number of records to return per request. Default is 20.

Required range: x >= 1
Example:

20

offset
integer
default:0

Number of initial records to skip for pagination.

Required range: x >= 0
Example:

0

Case insensitive search against domain names. Useful for finding specific domains in large lists.

Example:

"mycompany"

Response

200 - application/json

List of domains retrieved successfully

id
integer<int64>

Unique identifier for the domain

Example:

117

name
string

The domain name (e.g., "example.com"). This is the domain portion of your sending email addresses.

Example:

"piedpiper.com"

dnsProvider
string

Auto-detected DNS provider for this domain (e.g. "cloudflare", "other"), used to tailor DNS-setup instructions. Read-only.

Example:

"cloudflare"

dkim
object

DKIM (DomainKeys Identified Mail) DNS record configuration. DKIM cryptographically signs your emails to verify they haven't been tampered with. This is REQUIRED for sending emails.

returnPath
object

Return-Path (bounce handling) DNS record configuration. Configuring this allows bounce notifications to be properly routed through SendPost. RECOMMENDED for better deliverability.

track
object

Tracking domain DNS record configuration. When configured, click tracking links use your domain instead of SendPost's domain. RECOMMENDED for brand consistency and improved click-through rates.

dmarc
object

DMARC (Domain-based Message Authentication, Reporting & Conformance) DNS record. DMARC builds on DKIM and SPF to provide email authentication and reporting. RECOMMENDED for enterprise senders.

dkimVerified
boolean

Whether the DKIM DNS record has been verified successfully

Example:

true

dmarcVerified
boolean

Whether the DMARC DNS record has been verified successfully

Example:

false

returnPathVerified
boolean

Whether the Return-Path DNS record has been verified successfully

Example:

true

trackVerified
boolean

Whether the tracking domain DNS record has been verified successfully

Example:

true

verified
boolean

Overall verification status. True only if DKIM is verified (minimum requirement). For full verification, configure all DNS records.

Example:

true

domainRegisteredDate
string<date>

Date when this domain was originally registered (from WHOIS). Newer domains may have lower sender reputation initially.

Example:

"1995-08-14"

created
integer<int64>

UNIX epoch timestamp in nanoseconds when the domain was added to SendPost

Example:

1704067200000000000

dkimFailureReason
string

Detailed reason if DKIM verification failed (empty if verified or not attempted)

Example:

"DNS record not found. Please add the TXT record to your DNS provider."

dmarcFailureReason
string

Detailed reason if DMARC verification failed

Example:

""

trackFailureReason
string

Detailed reason if tracking domain verification failed

Example:

""

returnPathFailureReason
string

Detailed reason if Return-Path verification failed

Example:

""