Skip to main content
POST
/
api
/
v4
/
email
/
checks
Create an email check
curl --request POST \
  --url https://api.dataspike.io/api/v4/email/checks \
  --header 'Content-Type: application/json' \
  --header 'ds-api-token: <api-key>' \
  --data '
{
  "email": "<string>",
  "applicant_id": "<string>",
  "require_ownership": true,
  "locale": "<string>"
}
'
{
  "id": "019d4e88-f847-7aa0-892f-bd2d85537ffe",
  "email": "user@example.com",
  "verdict": "pass",
  "code": "email_invalid_syntax",
  "risk_score": 0,
  "checks": {
    "syntax_valid": true,
    "mx_found": true,
    "disposable": true,
    "role_based": true
  },
  "otp_sent": true,
  "otp_expires_at": "2024-01-01T00:10:00Z",
  "ownership_verified": true,
  "ownership_verified_at": "2024-01-01T00:00:00Z",
  "created_at": "2024-01-01T00:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.dataspike.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

ds-api-token
string
header
required

Body

application/json
email
string
required
applicant_id
string | null
require_ownership
boolean
locale
string | null

Response

Email check created.

id
string
Example:

"019d4e88-f847-7aa0-892f-bd2d85537ffe"

email
string
Example:

"user@example.com"

verdict
string
Example:

"pass"

code
string | null
Example:

"email_invalid_syntax"

risk_score
integer<int32>
Example:

0

checks
object
otp_sent
boolean
otp_expires_at
string | null
Example:

"2024-01-01T00:10:00Z"

ownership_verified
boolean
ownership_verified_at
string | null
Example:

"2024-01-01T00:00:00Z"

created_at
string
Example:

"2024-01-01T00:00:00Z"