Full Contact API

Social / OAuth Advanced HTTPS
Varies by plan (check documentation)

Overview

Full Contact is an identity resolution API that enriches contact data by returning social media profiles, job titles, and company info from an email address or other identifiers. It is useful for building CRM enrichment pipelines or lead qualification tools. Authentication uses OAuth 2.0 with a Bearer token obtained from your Full Contact dashboard.

💡

Beginner Tip

Use the Person Enrich endpoint with just an email address to get started — it returns the most comprehensive data for the least setup. Always handle 404 responses gracefully, as not every email will have enrichment data.

Available Data

Full Contact data via REST API
JSON-formatted response data
Requires OAuth authentication

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Full Contact",
    "description": "Get Social Media profiles and contact Information",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

fullName The full name of the person as inferred from their profiles
age Estimated age of the person
socialProfiles List of social media profiles each with a type such as linkedin or twitter and the profile URL
employment Current and past job positions including company name, title, and start/end dates
emails Known email addresses associated with this identity
photos Profile photo URLs associated with the person

Implementation Example

const url = "https://docs.fullcontact.com/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Invalid or missing Bearer token in the Authorization header
Generate an API key from your Full Contact dashboard and pass it as Authorization: Bearer YOUR_API_KEY
404 Not Found The email address has no matching profile in Full Contact database
This is a normal response — check the HTTP status code before processing, as not every email will return enrichment data
400 Bad Request Request body is missing the required identifier field such as email
Ensure you send a JSON body with at least one identifier like {"email": "[email protected]"}

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 3/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Social
Difficulty Advanced
Verified: 2026-04-04

Similar APIs

View All →