REST API · JSON · GDPR compliant

The People & Identity
Lookup API Built for
Developers

Phone lookup, email enrichment, face search, KYC validation, and 20+ more endpoints. One API key. Clean JSON responses. Works in any stack.

20+Endpoints
200+Countries
15 minTo integrate
GDPR Compliant
ISO 27001
RESTful · JSON
200+ Countries
Free Trial Credits

One API for Phone, Email, Identity & Fraud Signals

IRBIS is a REST API that lets your application look up a phone number, email address, name, or face and get back a structured identity profile — linked accounts, location signals, fraud indicators, and more. You send a POST request, you get back JSON.

🔌
Simple to integrate
Standard HTTP POST, API key authentication, JSON responses. No SDK required — works with any language. Most teams are sending live requests within 15 minutes of signing up.
🌍
Global data coverage
Phone numbers, emails, and names from 200+ countries. Not just US records — social signals, messaging app data, and web presence from platforms used globally.
Built for production
Async results model keeps your app from blocking on slow lookups. Poll the results endpoint at your pace. Credit-based pricing means you only pay for what you actually use.

20+ Lookup Endpoints in One API

Everything your app needs to verify identities, enrich contact data, screen for fraud, and run compliance checks — all under one API key.

POST
Phone Lookup
/api/developer/post · id: "phone"
Look up a phone number and get back the owner's name, location, linked social accounts, and photos from messaging apps. Works globally.
Identity
POST
Phone Verification
/api/developer/post · id: "real_phone"
Checks if a phone number is real, active, and reachable. Returns carrier, line type (mobile/VoIP/landline), and validity status.
Verification
POST
Phone vs Name Validator
/api/developer/post · id: "phone_name"
Cross-checks a phone number against a name. Returns a match score — useful for confirming that a customer is who they claim to be at onboarding.
Risk
POST
Email Lookup
/api/developer/post · id: "email"
Search by email address and get linked social profiles, usernames, and accounts registered to that email across 200+ platforms.
Enrichment
POST
Name SocialScan
/api/developer/post · id: "name"
Search by full name and find matching social profiles, linked usernames, and identity signals from social networks and public data.
Identity
POST
Face WebScan
/api/developer/post · id: "face"
Upload a face photo and find where that image appears online. Returns match confidence scores and source links. Useful for catching fake profile photos.
Risk
POST
KYC Validator
/api/developer/post · id: "kyc"
Validate customer identity for KYC and compliance flows. Cross-references submitted data against global identity signals to flag inconsistencies.
Compliance
POST
BreachScan
/api/developer/post · id: "breach"
Check if an email or phone number appears in known data breach databases. Returns breach names, dates, and data types exposed.
Risk
POST
IP Geolocation
/api/developer/post · id: "ip"
Get country, city, ISP, and VPN/proxy detection for any IP address. Use it to flag mismatches between a user's claimed location and actual IP.
Risk
POST
Phone vs IP Validator
/api/developer/post · id: "phone_ip"
Compares a phone number's registered country against the IP address location. A mismatch is one of the strongest signals of a fraudulent account.
Risk
POST
Leads Search
/api/developer/post · id: "leads"
Find contact information for people or businesses by name, company, or role. Returns emails, phone numbers, and social profiles for outreach.
Enrichment
POST
Compliance Screening
SSN Trace · Criminal · Watchlists · PEP
US-focused background checks including SSN trace, national criminal records, court records, and international watchlists and politically exposed persons (PEP).
Compliance

From Zero to First API Call in 15 Minutes

Register, grab your API key, and you're calling endpoints. Here's a real phone lookup request and what comes back.

Request · cURL
# Step 1 — Submit the lookup
curl -X POST \
  https://irbis.espysys.com/api/developer/post \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "searches": [{
      "id": "phone",
      "term": "+14155552671"
    }]
  }'

# Returns a lookupId immediately
{ "lookupId": "lk_8f3a91c2d4e5" }

# Step 2 — Retrieve results
curl \
  https://irbis.espysys.com/api/developer/results/lk_8f3a91c2d4e5 \
  -H "Authorization: Bearer YOUR_KEY"
Response · JSON 200 OK
{
  "status": "finished",
  "name": "Alex Rivera",
  "phone": "+14155552671",
  "location": "San Francisco, CA",
  "country": "US",
  "sources": [
    "WhatsApp",
    "Facebook",
    "Hiya"
  ],
  "photos": [
    { "url": "https://...",
      "source": "WhatsApp" }
  ],
  "confidence": 0.94,
  "carrier": "T-Mobile",
  "line_type": "mobile"
}
1
Register
Sign up at irbis.espysys.com — takes 60 seconds. Free trial credits included.
2
Get your API key
Go to the API Keys page, click Generate, copy your key. That's your Bearer token.
3
Submit a lookup
POST to /api/developer/post with your search term and id. You get back a lookupId.
4
Retrieve results
GET /api/developer/results/{lookupId} — the result is waiting for you as structured JSON.

What Teams Actually Build With IRBIS API

Not a research tool — an API you plug into your product. Here's how different teams use it in production.

🛒
E-commerce fraud prevention
At checkout or account creation, send the customer's phone number through the Phone Lookup and Phone vs Name endpoints. If the name on the order doesn't match the phone owner, flag it for review before shipping.
phonephone_namereal_phone
🏦
Fintech KYC & onboarding
During customer onboarding, cross-reference the submitted phone, email, and IP address. A phone from Nigeria, an IP from Romania, and a claimed US address is a pattern worth stopping before account creation completes.
kycphone_ipbreach
🎮
Gaming & platform trust
Fake accounts on gaming platforms cost real players and hurt retention. Run new registrations through phone verification and the Phone vs IP check to catch throwaway numbers and VPN users trying to evade bans.
real_phonephone_ipip
📋
Background screening & HR
Recruitment teams and background screening companies use IRBIS to quickly verify that a candidate's contact details match their identity, and to run compliance checks including PEP and watchlist screening.
namekycwatchlist
🔍
Investigations & OSINT
Journalists, law enforcement, and investigators use the Name, Email, and Face endpoints to map out someone's digital presence — linked accounts, usernames, and photos — from a single known identifier.
nameemailface
📊
CRM & sales enrichment
Sales teams use the Leads Search and Email Lookup endpoints to enrich contact records automatically — adding phone numbers, social profiles, and current job information to incoming leads without any manual research.
leadsemailname

The Async Lookup Model

IRBIS searches across dozens of data sources at once. The async model means your app doesn't wait — it submits, stores the ID, and retrieves when ready.

1
Submit request
POST your search term (phone, email, name, or image) with the relevant endpoint ID. Authenticate with your API key in the header.
2
Receive lookup ID
Instantly get back a lookupId. Store it. Your app is free to keep running — no blocking, no timeout issues while data sources are queried.
3
IRBIS queries sources
IRBIS runs your search across social platforms, carrier data, public records, and partner databases — all simultaneously in the background.
4
Retrieve JSON results
GET the results endpoint with your lookupId. Get back clean, structured JSON — names, locations, accounts, photos, confidence scores, fraud signals.
Credit-based pricing
Each lookup costs credits depending on the endpoint depth. You only spend credits when a lookup returns results — no charge for empty responses.
Check your balance anytime
Use the /api/developer/credits endpoint to query your remaining credits programmatically — useful for usage dashboards or alerting when credits are low.
Delete stored records
GDPR compliance is built in. Use the Delete Record endpoint to remove lookup results from IRBIS storage at any time — useful when your retention policy requires it.

IRBIS vs Other Identity & Enrichment APIs

Most identity APIs focus on one thing — email enrichment, or phone validation, or background checks. IRBIS covers all of them under one key.

FeatureIRBIS APIPeople Data LabsPiplClearbit
Phone number lookupPartial
Phone verification (live check)
Email enrichment
Face / image search
KYC validation endpointPartial
Breach scan
IP geolocation + VPN detection
Compliance screening (PEP/watchlists)Partial
International coverage (200+ countries)US/EU focus
Credit-based (pay per use)SubscriptionSubscriptionSubscription
Free trial credits✓ No card neededLimitedVia HubSpot
GDPR compliant✓ ISO 27001
The honest summary: if you need only email enrichment for B2B sales, PDL or Clearbit might be enough. If you need phone verification, fraud signals, face search, or KYC alongside enrichment — IRBIS covers it all under one API key without a subscription commitment.

Developer Questions, Answered

The questions we get most from developers integrating IRBIS for the first time.

Register at irbis.espysys.com, navigate to the API Keys page, and click Generate API Key. The key is active immediately — no approval wait, no setup call needed. Register here →
Phone Lookup, Phone Verification, Phone vs Name Validator, Email Lookup, Name SocialScan, Name WebScan, Face WebScan, Leads Search, KYC Validator, BreachScan, IP Geolocation, Phone vs IP Validator, AI Sentiment Analysis, Web Scraper, Psychological Portrait, and full Compliance Screening (SSN, Criminal, Watchlists, PEP, Court Records).
Yes. All calls are standard HTTP POST or GET requests. Authentication is via Bearer token in the Authorization header. All responses are JSON. No SDK required — any language that can make HTTP calls works fine.
You POST a lookup request and get back a lookupId immediately. IRBIS then runs the search in the background across multiple data sources. You GET the results endpoint with your lookupId whenever you're ready. This means your application never blocks on a slow data source.
Yes. IRBIS is GDPR compliant and ISO 27001 certified. All API requests are encrypted. Data is processed only to return your results and is not sold or shared with third parties. You can also delete any stored lookup records using the Delete Record endpoint.
IRBIS runs on credits — you buy a credit bundle and spend credits per lookup. The cost per lookup varies by endpoint depth. You only spend credits when a lookup returns results. No monthly subscription required. Free trial credits are included on signup.
Simple phone or email lookups typically come back in a few seconds. Deep enrichment requests that check 20+ sources may take 15–45 seconds. The async model means you're never blocking your application waiting — poll for results at your own pace.
Full docs are at api-docs.espysys.com — includes request/response schemas, code examples, error codes, and a reference page for every endpoint. Documentation is public and doesn't require login to read.

Ready to Send Your First API Call?

Free trial credits included. No credit card. No subscription. Just sign up and start building.