Domain
List domains
Getting Started
- Welcome to Self Mail Kit
- How to Deploy
API Reference
Endpoints
- Email
- Domain
- Audience
- Contact
Domain
List domains
Endpoint: v1/domains
List all domains associated with your account.
curl --request GET \
--url https://api.{your-domain.com}/v1/domains \
--header 'Authorization: Bearer <token>'
{
"domains": [
{
"id": "0195a927-b706-725a-94dd-372770d920f2",
"name": "onboarding.selfmailkit.com",
"verified_for_sending_status": true,
"verification_info": {
"last_checked_timestamp": "2025-03-25T11:16:20.217Z",
"last_success_timestamp": "2025-03-25T11:16:20.499Z",
"error_type": "HOST_NOT_FOUND",
"soa_record": {}
},
"public_key": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC7Zdux3HKFr8FkO6S0E5PKtY2KaAk8iqwKmw3ak9KwvwYExYLmguKGCqQb0jHshR/z1i9DEcSV+3rKoLL3R3Rn7A+Ua0zfJoFwOoOVwSGe9CgZ4geAzuSfo1wNSmaJzbtYZ1dOqSV0sbp8lKCeiLO5eDRIBVMcbULcVJA+/dAQfQIDAQAB",
"status": "SUCCESS",
"dns_records": [
{
"name": "dkim._domainkey.onboarding",
"for": "DKIM",
"type": "TXT",
"value": "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC7Zdux3HKFr8FkO6S0E5PKtY2KaAk8iqwKmw3ak9KwvwYExYLmguKGCqQb0jHshR/z1i9DEcSV+3rKoLL3R3Rn7A+Ua0zfJoFwOoOVwSGe9CgZ4geAzuSfo1wNSmaJzbtYZ1dOqSV0sbp8lKCeiLO5eDRIBVMcbULcVJA+/dAQfQIDAQAB",
"required": true
},
{
"name": "send.onboarding",
"for": "MAIL FROM domain",
"type": "MX",
"priority": 10,
"value": "feedback-smtp.eu-central-1.amazonses.com",
"required": true
},
{
"name": "send.onboarding",
"for": "MAIL FROM domain",
"type": "TXT",
"value": "\"v=spf1 include:amazonses.com ~all\"",
"required": true
},
{
"name": "_dmarc.onboarding",
"for": "DMARC (highly recommended)",
"type": "TXT",
"value": "v=DMARC1; p=none;",
"required": false
}
],
"created": 1742299707142,
"is_warmed_up": false,
"warmed_up_at": null,
"created_by": {
"email": "admin@company.com",
"first_name": null,
"last_name": null,
"profile_picture": "https://cdn.company.com/profiles/admin-avatar.jpg"
}
}
],
"count": 4,
"cursor": null
}
Authorizations
API key with format "Bearer {your-api-key}"
Query Parameters
Pagination cursor. The cursor will always be returned in the response:
- If there are more domains, it will contain the ID of the last domain in the current page
- If there are no more domains, it will be null
Response
200
application/json
OK
The response is of type any
.
curl --request GET \
--url https://api.{your-domain.com}/v1/domains \
--header 'Authorization: Bearer <token>'
{
"domains": [
{
"id": "0195a927-b706-725a-94dd-372770d920f2",
"name": "onboarding.selfmailkit.com",
"verified_for_sending_status": true,
"verification_info": {
"last_checked_timestamp": "2025-03-25T11:16:20.217Z",
"last_success_timestamp": "2025-03-25T11:16:20.499Z",
"error_type": "HOST_NOT_FOUND",
"soa_record": {}
},
"public_key": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC7Zdux3HKFr8FkO6S0E5PKtY2KaAk8iqwKmw3ak9KwvwYExYLmguKGCqQb0jHshR/z1i9DEcSV+3rKoLL3R3Rn7A+Ua0zfJoFwOoOVwSGe9CgZ4geAzuSfo1wNSmaJzbtYZ1dOqSV0sbp8lKCeiLO5eDRIBVMcbULcVJA+/dAQfQIDAQAB",
"status": "SUCCESS",
"dns_records": [
{
"name": "dkim._domainkey.onboarding",
"for": "DKIM",
"type": "TXT",
"value": "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC7Zdux3HKFr8FkO6S0E5PKtY2KaAk8iqwKmw3ak9KwvwYExYLmguKGCqQb0jHshR/z1i9DEcSV+3rKoLL3R3Rn7A+Ua0zfJoFwOoOVwSGe9CgZ4geAzuSfo1wNSmaJzbtYZ1dOqSV0sbp8lKCeiLO5eDRIBVMcbULcVJA+/dAQfQIDAQAB",
"required": true
},
{
"name": "send.onboarding",
"for": "MAIL FROM domain",
"type": "MX",
"priority": 10,
"value": "feedback-smtp.eu-central-1.amazonses.com",
"required": true
},
{
"name": "send.onboarding",
"for": "MAIL FROM domain",
"type": "TXT",
"value": "\"v=spf1 include:amazonses.com ~all\"",
"required": true
},
{
"name": "_dmarc.onboarding",
"for": "DMARC (highly recommended)",
"type": "TXT",
"value": "v=DMARC1; p=none;",
"required": false
}
],
"created": 1742299707142,
"is_warmed_up": false,
"warmed_up_at": null,
"created_by": {
"email": "admin@company.com",
"first_name": null,
"last_name": null,
"profile_picture": "https://cdn.company.com/profiles/admin-avatar.jpg"
}
}
],
"count": 4,
"cursor": null
}