Agent Lookup

Token-optimized email lookup designed for AI agents. Uses compact field keys and supports selective field retrieval.

POST /api/agent/lookup

Agent Lookup

cURL

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

200

{
  "n": "Satya Nadella",
  "e": "[e-mail]",
  "co": "Microsoft",
  "role": "CEO",
  "ind": "Technology",
  "loc": "Redmond, US",
  "bloc": "Hyderabad, India",
  "cloc": "Redmond, Washington, US",
  "v": "ok",
  "s": {
    "li": "https://linkedin.com/in/satyanadella"
  },
  "b": {
    "count": 12,
    "svc": ["Adobe", "LinkedIn"]
  },
  "reg": {
    "count": 3,
    "svc": ["Twitter", "Spotify", "GitHub"]
  }
}

Authentication

Requires a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Request

e · string · required

The email address to look up.

fields · string

Comma-separated list of fields to return. Omit to return all fields.

Available fields: n, e, co, role, ind, loc, bloc, cloc, bio, age, g, edu, pic, v, s, b, reg, news, pub

Field reference

Key	Description
n	Full name
e	Email
co	Company
role	Job role
ind	Industry
loc	Location (city, country)
bloc	Birthplace
cloc	Current/company location
bio	Biography
age	Age
g	Gender
edu	Education (level + university + field)
pic	Photo URL
v	Email validity (ok, invalid, disposable, unknown)
s	Social links (li, tw, ig, fb, gh)
b	Breach info (count, svc, data)
reg	Registered services (count, svc)
news	News mentions (t, u, d, s)
pub	Publications (t, u, y, c)

Example request

cURL

curl -X POST "https://encrata.com/api/agent/lookup?fields=n,co,role,s" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"e": "[e-mail]"}'

Response

n · string

Full name (first + middle + last).

e · string

Email address.

co · string

Company name.

role · string

Job role / title.

ind · string

Industry.

loc · string

Location as “city, country”.

bloc · string

Birthplace (parsed from knowledge graph).

cloc · string

Current/company location (from ContactOut company HQ).

bio · string

Short biography.

age · string

Age.

g · string

Gender.

edu · string

Education summary (level, university, field).

pic · string

Profile photo URL.

v · string

Email validity: ok, invalid, disposable, or unknown.

s · object

Social media links.

Show Social fields

li · string

LinkedIn URL

tw · string

Twitter/X URL

ig · string

Instagram URL

fb · string

Facebook URL

gh · string

GitHub URL

b · object

Data breach exposure (from HIBP).

Show Breach fields

count · integer

Number of breaches

svc · string[]

Breached service names

data · string[]

Exposed data types

reg · object

Registered services (from Holehe + Scanner).

Show Registered fields

count · integer

Number of registered services

svc · string[]

Service names

news · array

News mentions.

Show News item

t · string

Title

u · string

URL

d · string

Date

s · string

Source

pub · array

Academic publications.

Show Publication item

t · string

Title

u · string

URL

y · integer

Year

c · integer

Cited by count

Example response

{
  "n": "Satya Nadella",
  "co": "Microsoft",
  "role": "CEO",
  "bloc": "Hyderabad, India",
  "cloc": "Redmond, Washington, US",
  "v": "ok",
  "s": {
    "li": "https://linkedin.com/in/satyanadella"
  },
  "b": {
    "count": 12,
    "svc": ["Adobe", "LinkedIn"]
  },
  "reg": {
    "count": 3,
    "svc": ["Twitter", "Spotify", "GitHub"]
  }
}

200

{
  "n": "Satya Nadella",
  "e": "[e-mail]",
  "co": "Microsoft",
  "role": "CEO",
  "ind": "Technology",
  "loc": "Redmond, US",
  "bloc": "Hyderabad, India",
  "cloc": "Redmond, Washington, US",
  "v": "ok",
  "s": {
    "li": "https://linkedin.com/in/satyanadella"
  },
  "b": {
    "count": 12,
    "svc": ["Adobe", "LinkedIn"]
  },
  "reg": {
    "count": 3,
    "svc": ["Twitter", "Spotify", "GitHub"]
  }
}