Our REST API

Subscription

POST /api/v1/subscriptions
For now this is for internal use only

Validation

POST /api/v1/validations

#1 Request:

  curl --header "Content-Type: application/json" \
    --header "X-API-KEY: {YOUR_API_KEY_HERE}" \
    --request POST \
    --data '{"email": "aaa@bbbco.u3k"}' \
    https://serendipia.email/api/v1/validations

Response:

  {
    "data": {
      "email": "aaa@bbbco.u3k",
      "is_tld_valid": false,
      "is_disposable": false
    }
  }

#2 Request:

  curl --header "Content-Type: application/json" \
    --header "X-API-KEY: {YOUR_API_KEY_HERE}" \
    --request POST \
    --data '{"email": "fixa@london2.space"}' \
    https://serendipia.email/api/v1/validations

Response:

  {
    "data": {
      "email": "fixa@london2.space",
      "is_tld_valid": true,
      "is_disposable": true
    }
  }

#3 Request:

  curl --header "Content-Type: application/json" \
    --header "X-API-KEY: {YOUR_API_KEY_HERE}" \
    --request POST \
    --data '{"email": "fdsafdsafdsfd"}' \
    https://serendipia.email/api/v1/validations

Response:

  {
    "error": {
      "message": "your email doesn't look like email: no @"
    }
  }