Domains: Routes
Run Commands
The single entry point for sending domains. Send 1 to 10 commands in one request and get one result per command.
https://g.sendcorex.com/v1/domainSame envelope as Contacts, Logs and Bounces & Complaints. The pages below this one document each command.
Errors are reported per command. A command that fails does not stop the others, and the HTTP status stays 200.
Domains are identified by their name (acme.com), never by an internal id.
Body parameters
commandsobject[]required1 to 10 commands, executed in order. The whole body can have up to 1 MB.
commands[].commandstringrequiredlist_domains,get_domain,add_domain,delete_domain,update_domain_description,list_free_domains,start_dkim_upgrade,cancel_dkim_upgrade,send_dns_instructionsorrequest_domain_remediation.commands[].argsobjectoptionalThe command arguments. Any value can be a
$refto the result of an earlier command.commands[].idstringoptionalYour own identifier for the result. Defaults to the index (
"0","1"…). Required if you want to use$ref.
Quick start
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/domain',
{
commands: [
{
command: "list_domains",
id: "mine"
},
{
command: "list_free_domains",
id: "free"
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
for (const result of response.data.results) {
if (result.type !== 'SUCCESS') console.error(result.id, result.code, result.message);
else console.log(result.id, result.data);
}Response
{
"type": "SUCCESS",
"results": [
{
"command": "list_domains",
"id": "mine",
"type": "SUCCESS",
"took_ms": 6,
"data": {
"domains": [
{
"domain": "acme.com",
"validated": true,
"has_mx": true,
"has_spf": true,
"has_dkim": true,
"has_dmarc": true,
"has_return_path": true,
"description": "Transactional (app emails)",
"dkim_key_size": 2048,
"dkim_deprecated": false,
"dkim_upgrade_pending": false,
"created_at": "2026-09-02T14:21:07.118Z",
"updated_at": "2026-10-21T02:40:51.902Z"
}
]
}
},
{
"command": "list_free_domains",
"id": "free",
"type": "SUCCESS",
"took_ms": 0,
"data": {
"domains": [
"corexsend.com",
"inboxtaken.com",
"outsending.com",
"shieldhaus.uk",
"shieldhaus.info",
"mailverifypro.info",
"mailverifypro.online",
"mailverifypro.store",
"mailverifypro.org"
]
}
}
]
}Response fields
typeAlways
SUCCESSwhen the request itself was accepted.results[].commandThe command that produced this result.
results[].idThe
idyou sent, or the index of the command.results[].typeSUCCESSorERROR.results[].took_msTime the command took inside the server. Commands that check DNS take longer.
results[].dataThe command output. Only present when
typeisSUCCESS.results[].code / messageThe error. Only present when
typeisERROR.
Authentication
Use the API key you create in the dashboard, under Developers → API Keys, with the scopes the commands need.
AuthorizationSend
Authorization: <api key>orAuthorization: Bearer <api key>.domain:readlist_domains,get_domain,list_free_domainsandsend_dns_instructions.domain:createadd_domain,start_dkim_upgrade,cancel_dkim_upgrade,update_domain_descriptionandrequest_domain_remediation.domain:deletedelete_domain. Give it only to keys that really need it: deleting a domain also deletes its senders.Mailbox tokensThe webmail token does not work here. It is rejected with
WRONG_CREDENTIAL_TYPE.Allowed IPsIf the key has an IP allowlist, requests from other IPs get
403 IP_NOT_ALLOWED.
Chaining with $ref
Add a domain and read it back in one request: the second command takes the domain from the first result.
add_domain → get_domain
{
"commands": [
{
"command": "add_domain",
"id": "new",
"args": {
"domain": "acme.com"
}
},
{
"command": "get_domain",
"args": {
"domain": {
"$ref": "new",
"path": "domain"
}
}
}
]
}Rate limits
Two limits. The first one is for the whole route, the second one for some commands.
15 requests / secondPer IP + API key. Over it, HTTP 429 with a
Retry-Afterheader.15 in flightAt most 15 requests being processed at the same time, per IP + API key.
Per command, per accountadd_domain10/min ·get_domain60/min ·delete_domain30/min ·start_dkim_upgradeandcancel_dkim_upgrade10/min ·update_domain_description20/min ·send_dns_instructionsandrequest_domain_remediation5/min. Over it, that command answersRATE_LIMITED.No cacheEvery call reads the database (and the DNS, for
get_domain). What you get is always current.
Errors
HTTP-level errors return type, code and message. Errors marked CMD come back inside the command result, with HTTP 200.
- 400
INVALID_JSONThe body is not {"commands":[...]} or is larger than 1 MB.
- 400
INVALID_ARGSThe request has no commands or more than 10.
- 401
MISSING_AUTH_HEADERNo Authorization header was sent.
- 401
INVALID_API_KEYThe API key does not exist, was revoked or was disabled in the dashboard.
- 401
API_KEY_EXPIREDThe API key passed the expiration date set in the dashboard.
- 401
WRONG_CREDENTIAL_TYPEA mailbox token was sent. The Domains API needs a dashboard API key.
- 403
IP_NOT_ALLOWEDThe request came from an IP that is not in the allowed IPs of the key.
- 403
ACCOUNT_BLOCKEDThe account is blocked.
- 403
MISSING_SCOPEThe key has no `domain:*` scope, so no command can run.
- 429
RATE_LIMITEDMore than 15 requests/s or 15 in flight for the same IP + API key. Wait the number of seconds in Retry-After.
- 503
AUTH_UNAVAILABLEAuthentication is temporarily unavailable. Try again.
- CMD
UNKNOWN_COMMANDThe command name does not exist.
- CMD
INTERNALServer error. The detail is only written to the server log.