Email Identity

POST

api

identity

Email Identity

curl --request POST \
  --url https://developer.encrata.com/api/email/identity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>"
}
'

import requests

url = "https://developer.encrata.com/api/email/identity"

payload = { "email": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

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

fetch('https://developer.encrata.com/api/email/identity', 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://developer.encrata.com/api/email/identity",
  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([
    'email' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://developer.encrata.com/api/email/identity"

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

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://developer.encrata.com/api/email/identity")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://developer.encrata.com/api/email/identity")

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

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

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

{
  "email": "jane@example.com",
  "person": {
    "first_name": "Jane",
    "last_name": "Doe",
    "company": "Acme Inc",
    "job_role": "Head of Product",
    "industry": "Software",
    "city": "San Francisco",
    "country": "United States",
    "bio": "Product leader focused on developer tools.",
    "photo_url": "https://.../jane.jpg",
    "socials": {
      "linkedin": "https://www.linkedin.com/in/janedoe",
      "twitter": "https://x.com/janedoe",
      "github": "https://github.com/janedoe"
    }
  },
  "files": { "json": "", "csv": "" },
  "credits": 1000
}

{ "error": "Insufficient credits. Please top up your account." }

{ "error": "Invalid email address" }

Overview

Email Identity resolves the real person behind an email address into a structured profile: name, job role, company, industry, location, education, professional history, social profiles, and (when a phone number is discovered) reverse-phone owner intel. This is a premium lookup. It uses the dedicated identity resolver (not the general web-search lookup) and costs 1,000 credits per address. There are two ways to run it:

Single lookup (POST /api/email/identity): the endpoint documented on this page, callable with a JWT or an API key.
Async jobs (POST /api/jobs/identity): resolve a whole uploaded list in the background. See Bulk (asynchronous) below.

Authentication

Requires an API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Request

string

required

The email address to resolve.

Example request

curl -X POST "https://developer.encrata.com/api/email/identity" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

import requests

resp = requests.post(
    "https://developer.encrata.com/api/email/identity",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"email": "test@example.com"},
)
print(resp.json())

const resp = await fetch("https://developer.encrata.com/api/email/identity", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "test@example.com" }),
});
const data = await resp.json();

Response

Returns the resolved profile wrapped in a person object, plus billing fields. Fields inside person are empty when there is no value, so the profile only contains what was actually found.

string

The email address that was resolved.

object

The resolved profile. Key fields:

first_name, middle_name, last_name: the person’s name
company, job_role, industry: current employment
city, country, current_location: location
bio, education, education_level, university, field_of_study
photo_url: profile photo
socials: linkedin, twitter, instagram, facebook, github
company_profile: firmographics for the employer (size, industry, funding)
pdl: professional profile (work history, skills, certifications)
phone_owner: reverse-phone owner intel when a number is discovered (owner name, locations, addresses, relatives, extra emails, social profiles)

number

Credits charged for this request. 1000 on a fresh charge, or 0 when you were already charged for this address within the billing window (a free repeat).

boolean

Present and true only when the profile was served from cache. This is independent of billing: a cached result is still charged 1000 on your first request for that address in the window.

object

Present but unused for this endpoint (json and csv are empty strings).

Errors

Errors return a JSON body of the form {"error": "<message>"} with the matching HTTP status code.

Status	Message	Cause
`400`	`Invalid request body`	Malformed JSON
`400`	`Invalid email address`	Address fails syntax parsing
`400`	`The email domain does not exist or can't receive email`	Domain has no valid mail records
`401`	`API key required` / `bad key`	Missing or invalid API key
`401`	`Unauthorized`	The key’s account could not be resolved
`402`	`Insufficient credits. Please top up your account.`	Not enough credits and not a free repeat
`405`	`Only POST method is allowed`	Wrong HTTP method
`502`	`Identity lookup is temporarily unavailable. Please try again.`	Transient provider error, retry shortly

Credits

Each lookup costs 1,000 credits. Billing is per-customer: 1,000 on the first lookup of an address, 0 for repeats within the billing window. A cached result is still charged on your first lookup. See Credits for details.

Identity resolution may expand a discovered phone number into its owner via reverse-phone lookup, adding a phone_owner block inside person (owner name, locations, addresses, relatives, extra emails, and social profiles).

{
  "email": "jane@example.com",
  "person": {
    "first_name": "Jane",
    "last_name": "Doe",
    "company": "Acme Inc",
    "job_role": "Head of Product",
    "industry": "Software",
    "city": "San Francisco",
    "country": "United States",
    "bio": "Product leader focused on developer tools.",
    "photo_url": "https://.../jane.jpg",
    "socials": {
      "linkedin": "https://www.linkedin.com/in/janedoe",
      "twitter": "https://x.com/janedoe",
      "github": "https://github.com/janedoe"
    }
  },
  "files": { "json": "", "csv": "" },
  "credits": 1000
}

{ "error": "Insufficient credits. Please top up your account." }

{ "error": "Invalid email address" }

Bulk (asynchronous)

To resolve a whole list, submit it as an async job instead of looping this endpoint. One entrypoint handles every lookup - set type=identity - and a webhook delivers the finished file when it’s done.

curl -X POST "https://developer.encrata.com/api/jobs/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "type=identity" \
  -F "download_link=true" \
  -F "file=@list.csv"

Up to 1,000,000 emails per job, charged 1,000 credits per email - size your list against your balance first.
download_link=true returns a download_url in the bulk.completed webhook; fetch it with your API key.
Export filters: all, found.

See the Bulk Operations guide for the webhook payload, status checks, and download options.

Email Identity

curl --request POST \
  --url https://developer.encrata.com/api/email/identity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>"
}
'

import requests

url = "https://developer.encrata.com/api/email/identity"

payload = { "email": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

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

fetch('https://developer.encrata.com/api/email/identity', 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://developer.encrata.com/api/email/identity",
  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([
    'email' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://developer.encrata.com/api/email/identity"

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

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://developer.encrata.com/api/email/identity")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://developer.encrata.com/api/email/identity")

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

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

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

{
  "email": "jane@example.com",
  "person": {
    "first_name": "Jane",
    "last_name": "Doe",
    "company": "Acme Inc",
    "job_role": "Head of Product",
    "industry": "Software",
    "city": "San Francisco",
    "country": "United States",
    "bio": "Product leader focused on developer tools.",
    "photo_url": "https://.../jane.jpg",
    "socials": {
      "linkedin": "https://www.linkedin.com/in/janedoe",
      "twitter": "https://x.com/janedoe",
      "github": "https://github.com/janedoe"
    }
  },
  "files": { "json": "", "csv": "" },
  "credits": 1000
}

{ "error": "Insufficient credits. Please top up your account." }

{ "error": "Invalid email address" }

Overview

Email

Password

Workflows

API Keys

Webhooks

Account

Overview

Authentication

Request

Example request

Response

Errors

Credits

Bulk (asynchronous)

​Overview

​Authentication

​Request

​Example request

​Response

​Errors

​Credits

​Bulk (asynchronous)

Overview

Authentication

Request

Example request

Response

Errors

Credits

Bulk (asynchronous)