curl --request GET \
--url https://app.sendmux.ai/api/v1/domains/{public_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.sendmux.ai/api/v1/domains/{public_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sendmux.ai/api/v1/domains/{public_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.sendmux.ai/api/v1/domains/{public_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"meta": {
"request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"ok": true,
"data": {
"created_at": "<string>",
"dns_records": {
"dkim": [
{
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
],
"dmarc": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
},
"mail_from": {
"mx": {
"name": "bounce.acme.com",
"priority": 10,
"target": "feedback-smtp.eu-central-1.amazonses.com"
},
"spf": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
},
"mx": [
{
"priority": 10,
"target": "mail.sendmux.ai"
}
],
"spf": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
},
"verification": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
},
"domain": "mail.acme.com",
"id": "mdom_clxxxxxxxxxxxxxxxxxxxxxxxxx",
"mailbox_count": 14,
"mode": "send_receive",
"ses_dkim_signing_enabled": true,
"ses_dkim_status": "<string>",
"ses_identity_checked_at": "<string>",
"ses_identity_verification_status": "<string>",
"ses_mail_from_status": "<string>",
"ses_verified_for_sending": true,
"verified_at": "<string>"
}
}{
"error": {
"code": "invalid_parameter",
"message": "<string>",
"retryable": false,
"doc_url": "<string>",
"errors": [
{
"code": "invalid_string",
"field": "recipient.email",
"message": "<string>"
}
],
"param": "<string>"
},
"meta": {
"request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"ok": false
}Get a mailbox domain
Returns a single domain including its DNS records and latest verification state. Responses carry a weak ETag header — send it back as If-None-Match on the next request and the server will return 304 Not Modified (no body) when the resource has not changed.
curl --request GET \
--url https://app.sendmux.ai/api/v1/domains/{public_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.sendmux.ai/api/v1/domains/{public_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sendmux.ai/api/v1/domains/{public_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.sendmux.ai/api/v1/domains/{public_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"meta": {
"request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"ok": true,
"data": {
"created_at": "<string>",
"dns_records": {
"dkim": [
{
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
],
"dmarc": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
},
"mail_from": {
"mx": {
"name": "bounce.acme.com",
"priority": 10,
"target": "feedback-smtp.eu-central-1.amazonses.com"
},
"spf": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
},
"mx": [
{
"priority": 10,
"target": "mail.sendmux.ai"
}
],
"spf": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
},
"verification": {
"name": "_sendmux.acme.com",
"value": "sendmux-verify=team_abc123"
}
},
"domain": "mail.acme.com",
"id": "mdom_clxxxxxxxxxxxxxxxxxxxxxxxxx",
"mailbox_count": 14,
"mode": "send_receive",
"ses_dkim_signing_enabled": true,
"ses_dkim_status": "<string>",
"ses_identity_checked_at": "<string>",
"ses_identity_verification_status": "<string>",
"ses_mail_from_status": "<string>",
"ses_verified_for_sending": true,
"verified_at": "<string>"
}
}{
"error": {
"code": "invalid_parameter",
"message": "<string>",
"retryable": false,
"doc_url": "<string>",
"errors": [
{
"code": "invalid_string",
"field": "recipient.email",
"message": "<string>"
}
],
"param": "<string>"
},
"meta": {
"request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"ok": false
}Authorizations
Sendmux API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.
Headers
Weak ETag from a previous response. Returns 304 when unchanged.
Path Parameters
Domain public ID
"mdom_clxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
Domain
true Hide child attributes
Hide child attributes
ISO 8601 creation timestamp
Hide child attributes
Hide child attributes
Custom MAIL FROM records for Amazon SES bounce handling
Hide child attributes
Hide child attributes
MX record for Amazon SES bounce handling
Fully qualified domain name
"mail.acme.com"
Public ID
"mdom_clxxxxxxxxxxxxxxxxxxxxxxxxx"
Active mailboxes currently using this domain
x >= 014
send_only verifies outbound DNS only. send_receive also verifies MX records and can host mailboxes.
send_only, send_receive "send_receive"
Whether Amazon SES DKIM signing is currently enabled for this identity
Amazon SES DKIM status (pending/success/failed/temporary_failure/not_started)
ISO 8601 timestamp of the latest complete Amazon SES identity check
Latest Amazon SES identity verification status
Amazon SES MAIL FROM status (pending/success/failed/temporary_failure/not_started)
Whether Amazon SES currently permits sending for this identity
Current verification state
pending, verified, failed ISO 8601 timestamp of last successful verification
Was this page helpful?