API URL
POST /api/v1/lookup
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
domains
required
string
Single domain or comma-separated domains for GET lookup
resolveIps
optional
boolean
Include A/AAAA resolution for each MX exchange
validateSmtp
optional
boolean
Check SMTP connectivity on port 25
includeSpf
optional
boolean
Include parsed SPF record details
Example Request
Code
GET https://datpaq.com/api/v1/mx-lookup?api_key=your-api-key&domains=gmail.com&resolveIps=falseSuccessful Response
Status
HTML
200 OKBody
Code
{
"success": true,
"count": 1,
"data": [
{
"domain": "gmail.com",
"mxRecords": [
{
"priority": 5,
"exchange": "gmail-smtp-in.l.google.com"
}
]
}
],
"processingTime": "4ms",
"correlationId": "1780005628531-vunylzqs6"
}Field
Type
success
boolean
count
number
data
array
data.domain
string
data.mxRecords
array
data.mxRecords.priority
number
data.mxRecords.exchange
string
data.mxRecords.ipAddresses
array
data.mxRecords.smtpOpen
boolean
data.spf
object
data.error
string
processingTime
string
correlationId
string
error
string
invalidDomains
array
Error Response
Example
Code
400 ValidationError - Missing or invalid domains input: domains must be string or array and must satisfy format rules
400 BatchLimitExceeded - More than 50 domains requested: Input batch exceeds supported max size
400 ValidationError - Invalid domain format: One or more domain values fail validation
404 NotFound - Unknown route accessed: Endpoint is not implemented by service
500 InternalServerError - Unhandled lookup processing failure: Unexpected runtime failure during lookupLast Updated: May 4, 2026