Validate Email

curl --request POST \
  --url https://api.linkupapi.com/v2/enrich \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "params": {
    "email": "<string>"
  }
}
'

import requests

url = "https://api.linkupapi.com/v2/enrich"

payload = {
    "action": "<string>",
    "params": { "email": "<string>" }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({action: '<string>', params: {email: '<string>'}})
};

fetch('https://api.linkupapi.com/v2/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkupapi.com/v2/enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'action' => '<string>',
    'params' => [
        'email' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkupapi.com/v2/enrich"

	payload := strings.NewReader("{\n  \"action\": \"<string>\",\n  \"params\": {\n    \"email\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v2/enrich")
  .header("Content-Type", "application/json")
  .body("{\n  \"action\": \"<string>\",\n  \"params\": {\n    \"email\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkupapi.com/v2/enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"action\": \"<string>\",\n  \"params\": {\n    \"email\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "email": "jane.doe@acme-corp.com",
    "is_valid": true,
    "is_catch_all": true,
    "reachability": "risky",
    "is_deliverable": true,
    "syntax_valid": true
  },
  "metadata": {
    "action": "validate_email",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "email is required"
  },
  "metadata": {
    "action": "validate_email",
    "credits_consumed": 0,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

POST

enrich

Validate Email

curl --request POST \
  --url https://api.linkupapi.com/v2/enrich \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "params": {
    "email": "<string>"
  }
}
'

import requests

url = "https://api.linkupapi.com/v2/enrich"

payload = {
    "action": "<string>",
    "params": { "email": "<string>" }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({action: '<string>', params: {email: '<string>'}})
};

fetch('https://api.linkupapi.com/v2/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkupapi.com/v2/enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'action' => '<string>',
    'params' => [
        'email' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkupapi.com/v2/enrich"

	payload := strings.NewReader("{\n  \"action\": \"<string>\",\n  \"params\": {\n    \"email\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v2/enrich")
  .header("Content-Type", "application/json")
  .body("{\n  \"action\": \"<string>\",\n  \"params\": {\n    \"email\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkupapi.com/v2/enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"action\": \"<string>\",\n  \"params\": {\n    \"email\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "email": "jane.doe@acme-corp.com",
    "is_valid": true,
    "is_catch_all": true,
    "reachability": "risky",
    "is_deliverable": true,
    "syntax_valid": true
  },
  "metadata": {
    "action": "validate_email",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "email is required"
  },
  "metadata": {
    "action": "validate_email",
    "credits_consumed": 0,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

Overview

Checks whether an email address is valid and deliverable. Returns syntax validity, deliverability, catch-all status, and a reachability verdict. No connected account is required for this action.

This endpoint consumes 1 credit per request.

Request

string

required

Must be "validate_email".

object

required

Show params properties

string

required

The email address to validate.

Response

boolean

Indicates whether the request was successful.

object

Show data properties

string

The email that was validated (echo of input).

boolean

true when the email passes syntax + MX + deliverability checks.

boolean

true if the domain accepts all addresses (deliverability is not a guarantee).

string

SMTP probe verdict: "safe", "risky", or "unknown".

boolean

true if the SMTP server accepts mail for this address.

boolean

true if the address has valid RFC syntax.

object

Show metadata properties

string

The action that was performed ("validate_email").

integer

Number of credits consumed (1).

string

ISO 8601 timestamp of the response.

{
  "success": true,
  "data": {
    "email": "jane.doe@acme-corp.com",
    "is_valid": true,
    "is_catch_all": true,
    "reachability": "risky",
    "is_deliverable": true,
    "syntax_valid": true
  },
  "metadata": {
    "action": "validate_email",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "email is required"
  },
  "metadata": {
    "action": "validate_email",
    "credits_consumed": 0,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

Getting Started

Accounts

Profiles

Messaging

Network

Content

Recruiting

Credits

Logs

Email Enrichment

Webhooks (Real-Time)

Validate Email

Overview

Request

Response