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_status": "<string>",
"ses_mail_from_status": "<string>",
"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_status": "<string>",
"ses_mail_from_status": "<string>",
"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"
Amazon SES DKIM status (pending/success/failed/temporary_failure/not_started)
Amazon SES MAIL FROM status (pending/success/failed/temporary_failure/not_started)
Current verification state
pending, verified, failed ISO 8601 timestamp of last successful verification
Was this page helpful?