Comprehensive profile dossier for a person

curl --request POST \
  --url https://api.lava.so/v1/enrich/profile \
  --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/profile"

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/profile', 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/profile",
  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/profile"

	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/profile")
  .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/profile")

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

{
  "profile": {
    "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>",
    "twitter": {
      "handle": "<string>",
      "recent_posts": [
        "<string>"
      ],
      "bio": "<string>",
      "followers": 123
    },
    "github": {
      "handle": "<string>",
      "recent_posts": [
        "<string>"
      ],
      "bio": "<string>",
      "followers": 123
    },
    "instagram": {
      "handle": "<string>",
      "recent_posts": [
        "<string>"
      ],
      "bio": "<string>",
      "followers": 123
    },
    "provenance": {},
    "confidence": 123
  },
  "narrative": "<string>",
  "citations": [
    {
      "section": "<string>",
      "source_id": "<string>",
      "url": "<string>"
    }
  ],
  "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

Comprehensive profile dossier for a person

Comprehensive person dossier. Runs /enrich/contact’s adapter set plus Wikipedia and Apify social adapters (Twitter, GitHub, Instagram — conditional on the matching handle in the input), in parallel with a direct Lava News fetch for recent business happenings (last 90 days). xAI Grok synthesizes structured profile fields plus a 2–4 paragraph narrative summary with citations linking the narrative back to source candidates and articles. Charges sum of upstream provider costs + LLM synthesis cost + $0.10 lava-enrich markup. News failure alone does NOT cause a 502 — the endpoint degrades gracefully with the narrative omitting the news section.

POST

enrich

profile

curl --request POST \
  --url https://api.lava.so/v1/enrich/profile \
  --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/profile"

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/profile', 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/profile",
  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/profile"

	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/profile")
  .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/profile")

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

{
  "profile": {
    "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>",
    "twitter": {
      "handle": "<string>",
      "recent_posts": [
        "<string>"
      ],
      "bio": "<string>",
      "followers": 123
    },
    "github": {
      "handle": "<string>",
      "recent_posts": [
        "<string>"
      ],
      "bio": "<string>",
      "followers": 123
    },
    "instagram": {
      "handle": "<string>",
      "recent_posts": [
        "<string>"
      ],
      "bio": "<string>",
      "followers": 123
    },
    "provenance": {},
    "confidence": 123
  },
  "narrative": "<string>",
  "citations": [
    {
      "section": "<string>",
      "source_id": "<string>",
      "url": "<string>"
    }
  ],
  "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

Authorization

string

header

required

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.

string | null

linkedin_url

string | null

name

string | null

company

string | null

phone

string | null

twitter_url

string | null

Twitter/X profile URL. When supplied, /profile additionally fans out to Apify Twitter scraper.

github_url

string | null

GitHub profile URL. When supplied, /profile additionally fans out to Apify GitHub scraper.

instagram_handle

string | null

Instagram handle (with or without @ prefix). When supplied, /profile additionally fans out to Apify Instagram scraper.

include_connected_crms

boolean | null

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

Synthesized profile with structured fields, narrative, citations, and per-field provenance. profile is null when the synthesizer's confidence is below threshold — markup is still charged.

profile

object | null

required

Comprehensive profile record. Subsumes the MergedContact shape plus a public bio and per-platform social profile blocks.

Show child attributes

narrative

string | null

required

citations

object[]

required

Show child attributes

sources_failed

object[]

required

Show child attributes

available_connections

string[]

required

cost

object

required

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

⌘I

Getting Started

Core Endpoints

Models

Services

Requests

Usage

Checkout Sessions

Customers

Plans

Subscriptions

Meters

Webhooks

Secret Keys

Credit Bundles

Wallet

Payment Methods

Spend Keys

Authentication

Gateway Settings

Skills

News Data

Search

Enrich

Comprehensive profile dossier for a person

Authorizations

Body

Response