Merged contact info for a person
curl --request POST \
--url https://api.lava.so/v1/enrich/contact \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "<string>",
"linkedin_url": "<string>",
"name": "<string>",
"company": "<string>",
"phone": "<string>",
"twitter_url": "<string>",
"github_url": "<string>",
"instagram_handle": "<string>",
"include_connected_crms": true
}
'import requests
url = "https://api.lava.so/v1/enrich/contact"
payload = {
"email": "<string>",
"linkedin_url": "<string>",
"name": "<string>",
"company": "<string>",
"phone": "<string>",
"twitter_url": "<string>",
"github_url": "<string>",
"instagram_handle": "<string>",
"include_connected_crms": True
}
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>',
linkedin_url: '<string>',
name: '<string>',
company: '<string>',
phone: '<string>',
twitter_url: '<string>',
github_url: '<string>',
instagram_handle: '<string>',
include_connected_crms: true
})
};
fetch('https://api.lava.so/v1/enrich/contact', 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.lava.so/v1/enrich/contact",
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>',
'linkedin_url' => '<string>',
'name' => '<string>',
'company' => '<string>',
'phone' => '<string>',
'twitter_url' => '<string>',
'github_url' => '<string>',
'instagram_handle' => '<string>',
'include_connected_crms' => true
]),
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://api.lava.so/v1/enrich/contact"
payload := strings.NewReader("{\n \"email\": \"<string>\",\n \"linkedin_url\": \"<string>\",\n \"name\": \"<string>\",\n \"company\": \"<string>\",\n \"phone\": \"<string>\",\n \"twitter_url\": \"<string>\",\n \"github_url\": \"<string>\",\n \"instagram_handle\": \"<string>\",\n \"include_connected_crms\": true\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://api.lava.so/v1/enrich/contact")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"<string>\",\n \"linkedin_url\": \"<string>\",\n \"name\": \"<string>\",\n \"company\": \"<string>\",\n \"phone\": \"<string>\",\n \"twitter_url\": \"<string>\",\n \"github_url\": \"<string>\",\n \"instagram_handle\": \"<string>\",\n \"include_connected_crms\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lava.so/v1/enrich/contact")
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 \"linkedin_url\": \"<string>\",\n \"name\": \"<string>\",\n \"company\": \"<string>\",\n \"phone\": \"<string>\",\n \"twitter_url\": \"<string>\",\n \"github_url\": \"<string>\",\n \"instagram_handle\": \"<string>\",\n \"include_connected_crms\": true\n}"
response = http.request(request)
puts response.read_body{
"contact": {
"name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>",
"company": "<string>",
"company_domain": "<string>",
"email": "<string>",
"linkedin_url": "<string>",
"phone": "<string>",
"location": "<string>",
"twitter_url": "<string>",
"github_url": "<string>",
"bio": "<string>",
"provenance": {},
"confidence": 123
},
"sources_failed": [
{
"provider": "<string>",
"reason": "<string>"
}
],
"available_connections": [
"<string>"
],
"cost": {
"total": "<string>",
"markup": "<string>",
"breakdown": {}
}
}{
"error": {
"message": "Invalid authentication credentials",
"code": "forward_token_json_invalid",
"status": 400,
"issues": [
{
"path": [
"model"
],
"message": "Missing required field: model"
},
{
"path": [
"messages",
"0",
"content"
],
"message": "Invalid message content format"
}
]
}
}{
"error": {
"message": "Invalid authentication credentials",
"code": "forward_token_json_invalid",
"status": 400,
"issues": [
{
"path": [
"model"
],
"message": "Missing required field: model"
},
{
"path": [
"messages",
"0",
"content"
],
"message": "Invalid message content format"
}
]
}
}{
"error": {
"message": "Invalid authentication credentials",
"code": "forward_token_json_invalid",
"status": 400,
"issues": [
{
"path": [
"model"
],
"message": "Missing required field: model"
},
{
"path": [
"messages",
"0",
"content"
],
"message": "Invalid message content format"
}
]
}
}Enrich
Merged contact info for a person
Narrow contact-info merger across Apollo, People Data Labs, and (when opted in) the caller’s connected CRMs (HubSpot/Folk/Affinity). Accepts any subset of person-side identifiers (email, linkedin_url, name+company, phone, twitter_url, github_url, instagram_handle) and returns a merged contact with per-field provenance citing which sources supplied each value. Best for sales/CRM workflows that need name/title/company/email/phone for a known person. Charges sum of upstream provider costs plus a $0.05 lava-enrich markup. The sibling /enrich/profile endpoint returns a richer dossier (social, news, narrative).
POST
/
enrich
/
contact
Merged contact info for a person
curl --request POST \
--url https://api.lava.so/v1/enrich/contact \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "<string>",
"linkedin_url": "<string>",
"name": "<string>",
"company": "<string>",
"phone": "<string>",
"twitter_url": "<string>",
"github_url": "<string>",
"instagram_handle": "<string>",
"include_connected_crms": true
}
'import requests
url = "https://api.lava.so/v1/enrich/contact"
payload = {
"email": "<string>",
"linkedin_url": "<string>",
"name": "<string>",
"company": "<string>",
"phone": "<string>",
"twitter_url": "<string>",
"github_url": "<string>",
"instagram_handle": "<string>",
"include_connected_crms": True
}
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>',
linkedin_url: '<string>',
name: '<string>',
company: '<string>',
phone: '<string>',
twitter_url: '<string>',
github_url: '<string>',
instagram_handle: '<string>',
include_connected_crms: true
})
};
fetch('https://api.lava.so/v1/enrich/contact', 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.lava.so/v1/enrich/contact",
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>',
'linkedin_url' => '<string>',
'name' => '<string>',
'company' => '<string>',
'phone' => '<string>',
'twitter_url' => '<string>',
'github_url' => '<string>',
'instagram_handle' => '<string>',
'include_connected_crms' => true
]),
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://api.lava.so/v1/enrich/contact"
payload := strings.NewReader("{\n \"email\": \"<string>\",\n \"linkedin_url\": \"<string>\",\n \"name\": \"<string>\",\n \"company\": \"<string>\",\n \"phone\": \"<string>\",\n \"twitter_url\": \"<string>\",\n \"github_url\": \"<string>\",\n \"instagram_handle\": \"<string>\",\n \"include_connected_crms\": true\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://api.lava.so/v1/enrich/contact")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"<string>\",\n \"linkedin_url\": \"<string>\",\n \"name\": \"<string>\",\n \"company\": \"<string>\",\n \"phone\": \"<string>\",\n \"twitter_url\": \"<string>\",\n \"github_url\": \"<string>\",\n \"instagram_handle\": \"<string>\",\n \"include_connected_crms\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lava.so/v1/enrich/contact")
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 \"linkedin_url\": \"<string>\",\n \"name\": \"<string>\",\n \"company\": \"<string>\",\n \"phone\": \"<string>\",\n \"twitter_url\": \"<string>\",\n \"github_url\": \"<string>\",\n \"instagram_handle\": \"<string>\",\n \"include_connected_crms\": true\n}"
response = http.request(request)
puts response.read_body{
"contact": {
"name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>",
"company": "<string>",
"company_domain": "<string>",
"email": "<string>",
"linkedin_url": "<string>",
"phone": "<string>",
"location": "<string>",
"twitter_url": "<string>",
"github_url": "<string>",
"bio": "<string>",
"provenance": {},
"confidence": 123
},
"sources_failed": [
{
"provider": "<string>",
"reason": "<string>"
}
],
"available_connections": [
"<string>"
],
"cost": {
"total": "<string>",
"markup": "<string>",
"breakdown": {}
}
}{
"error": {
"message": "Invalid authentication credentials",
"code": "forward_token_json_invalid",
"status": 400,
"issues": [
{
"path": [
"model"
],
"message": "Missing required field: model"
},
{
"path": [
"messages",
"0",
"content"
],
"message": "Invalid message content format"
}
]
}
}{
"error": {
"message": "Invalid authentication credentials",
"code": "forward_token_json_invalid",
"status": 400,
"issues": [
{
"path": [
"model"
],
"message": "Missing required field: model"
},
{
"path": [
"messages",
"0",
"content"
],
"message": "Invalid message content format"
}
]
}
}{
"error": {
"message": "Invalid authentication credentials",
"code": "forward_token_json_invalid",
"status": 400,
"issues": [
{
"path": [
"model"
],
"message": "Missing required field: model"
},
{
"path": [
"messages",
"0",
"content"
],
"message": "Invalid message content format"
}
]
}
}Authorizations
Bearer token authentication used for standard API calls. Format: 'Bearer YOUR_API_KEY'
Body
application/json
Person identifiers for /v1/enrich/contact and /v1/enrich/profile. At least one strong identifier (email, linkedin_url, phone, twitter_url, github_url, instagram_handle) OR name+company is required. Domain-only or company-only input returns 400.
Twitter/X profile URL. When supplied, /profile additionally fans out to Apify Twitter scraper.
GitHub profile URL. When supplied, /profile additionally fans out to Apify GitHub scraper.
Instagram handle (with or without @ prefix). When supplied, /profile additionally fans out to Apify Instagram scraper.
Opt-in flag for adding the caller's connected CRMs (HubSpot/Folk/Affinity) to the fanout. Only adapters for services the caller has actually connected are added; opt-in does not fan out to the universe of CRMs.
Response
Merged contact record. contact is null when the fanout returned candidates but no confident match was found — the markup is still charged because the work was performed.
Merged contact record with per-field provenance. Fields are null when the merger had no confident value. provenance maps each populated field to the array of source ids that contributed.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
CRM service names the caller has connected (hubspot, folk, affinity). Returned regardless of opt-in so callers can discover what's available.
Cost breakdown returned on every successful or no-match response. markup is the flat lava-enrich fee; breakdown lists each upstream provider's cost as reported by its adapter; total is markup + sum(breakdown).
Show child attributes
Show child attributes